🚨 Breaking Changes – Continuously Updated

[jokob-sk]

UPCOMING

• ⚠️🆕WARNING: Upgrading from v26.7.1 or earlier may require adding NET_RAW, NET_ADMIN, and NET_BIND_SERVICE container capabilities. Otherwise, the container may fail to start with python3: Operation not permitted (exit status 126). This primarily affects bridge-mode deployments.
• 🔺NEXT RELEASE REMOVAL: If you have implemented external applications using the OLD API endpoints, please migrate to the NEW API endpoints.

Timeline

• [2026-09-02] Moved plugins directory from /front/plugins to /server/plugins
• [2026-08-05] Notice given on moving plugins directory from /front/plugins to /server/plugins
• [2026-07-22] Upgrading bridge-mode deployments may require adding NET_RAW, NET_ADMIN, and NET_BIND_SERVICE as startup may fail with python3: Operation not permitted (exit status 126).
• [2026-04-06] Field name changes in notifications (JSON api integrations might be affected)
• [2026-03-15] Notice given on field name changes in notifications
• [2026-02-16] The port for SYNC plugin nodes will now follow the GRAPHQL_PORT setting. See the SYNC docs for details.
• [2026-01-18] You might need to re-enter and save your SMTP_PASS setting to re-enable emails
• [2026-01-18] Gradual removal of OLD API Endpoints has started, please migrate to the new API
• [2026-01-18] New capabilities (CHOWN, SETUID, SETGID) need to be added to docker-compose, see the docs for details
• [2026-01-10] For reverse proxies use the BACKEND_API_URL setting to point to your backend port
• [2025-12-03] Update SYNC plugin nodes to use the GRAPHQL_PORT. Update your SYNC_hub_url and SYNC_nodes. See the SYNC docs.
• [2025-12-03] Due to language string cleanup you will have to select your UI_LANG again and re-save your settings.
• [2025-12-03] Due to the format of the SMTP_PASS setting changes you will have to re-save your settings.
• [2025-12-03] The TZ=Europe/Berlin docker variable was replaced by a more common approach mapping - v /etc/localtime:/etc/localtime:ro
• [2025-12-03] Docker container volume locations changed, from /app to /data and a new tmpfs mount added. See Migration docs for details.
• [2025-11-30] Due to code refactoring, upgrading from versions earlier than v25.5.24 requires first updating to v25.5.24. See the upgrade docs for details.
• [2025-11-30] Docker-compose structure changed - see Migration docs for details
• [2025-10-26] Bare metal installation is currently broken, see ⚠Security Hardening Tasks #1241 for a workaround
• [2025-10-29] The netalertx-dev dev container is currently heavily worked on, please use the netalertx image
• [2025-10-30] See 🧪 Ongoing DEV branch testing #1250 for how to get the netalertx-dev branch running again