Backstage
January 8, 2026 ยท View on GitHub
node
version 24.11.1
headers: https://nodejs.org/download/release/v24.11.1/
bump versions
yarn backstage-cli versions:bump
install packages
yarn install
outdated packages
yarn upgrade-interactive
compile
yarn tsc
run dev
start db
podman compose -f docker-db-compose.yml up -d
start backstage
./run.sh
.env
AZURE_CLIENT_ID="..."
AZURE_CLIENT_SECRET="..."
AZURE_TENANT_ID="..."
app-config.local.yaml
backend:
auth:
externalAccess:
- type: legacy
options:
secret: ...
subject: legacy-catalog
- type: legacy
options:
secret: ...
subject: legacy-scaffolder
permission:
enabled: true
rbac:
admin:
users:
- name: 'group:default/backstage-admin'
- name: 'user:default/...'
superUsers:
- name: 'user:default/...'
Changelog
Signals
https://github.com/backstage/backstage/issues/23927
Send notifications
https://github.com/backstage/backstage/blob/master/beps/0001-notifications-system/README.md
curl -i -X POST 'http://localhost:7007/api/notifications' -H 'Authorization: Bearer mock-service-token' -H 'content-type: application/json' -d '{"recipients": {"entityRef": "user:development/guest", "type": "entity"}, "payload": {"title": "Hello", "link": "http://example.com"}}'
curl -i -X POST 'http://localhost:7007/api/notifications' -H 'Authorization: Bearer mock-service-token' -H 'content-type: application/json' -d '{"recipients": {"type": "broadcast"}, "payload": {"title": "Hello title", "description": "Notification description", "severity": "critical", "link": "http://example.com"}}'
curl -i -X POST 'http://localhost:7007/api/notifications' -H 'Authorization: Bearer eyJhbGciOiJFUzI1NiIsImtpZCI6IjViY2Y5OTA1LTVkMzktNGYzZC05NmVhLTZhMjAzZDg0OTFlNiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0OjcwMDcvYXBpL2F1dGgiLCJzdWIiOiJ1c2VyOmRlZmF1bHQvdGhpZXJyeS5jYXJlbHNfZ21haWwuY29tIiwiZW50IjpbInVzZXI6ZGVmYXVsdC90aGllcnJ5LmNhcmVsc19nbWFpbC5jb20iLCJncm91cDpkZWZhdWx0L2JhY2tzdGFnZS1hZG1pbiIsImdyb3VwOmRlZmF1bHQvYmFja3N0YWdlLXVzZXJzIiwiZ3JvdXA6ZGVmYXVsdC9tc2FsLXJlYWN0LWRlbW8uYWRtaW4iLCJncm91cDpkZWZhdWx0L21zYWwtcmVhY3QtZGVtby51c2VyIl0sImF1ZCI6ImJhY2tzdGFnZSIsImlhdCI6MTcxMjEyNzgyNSwiZXhwIjoxNzEyMTMxNDI1fQ.gnPNfSexj31LJlz6PdMIxDe3LQSV16AZUs1vG4KXndcQOMxREZS96ETNMVeXdcPrfaVWnSVPS-JZVtjDFUiOcw' -H 'content-type: application/json' -d '{"recipients": {"type": "broadcast"}, "payload": {"title": "Hello title", "description": "Notification description", "severity": "critical", "link": "http://example.com"}}'