2026-11-19 - CLI v3 Deprecation: Upgrade and Sign In Again by January 31, 2027
Effective Date: January 31, 2027
What is changing
From January 31, 2027, signageOS CLI v3 will be deprecated for security reasons. Upgrade to the latest CLI v4 release and update any copies pinned in projects, build images and CI/CD pipelines.
CLI v4 uses Auth0 browser-based authentication instead of the old username/password login. Existing local login state must be renewed after upgrading.
Local development
- Update the CLI:
npm install -g @signageos/cli@latest - Check the version:
sos --version - Run
sos loginagain and complete the browser sign-in for the correct region. Repeat for each profile you use. - Test your usual upload, build and device-management commands.
CI/CD and SDK integrations
Use explicitly configured API tokens for unattended jobs, not a copied interactive login or credentials extracted from an organization
response. For CLI pipelines, configure SOS_API_IDENTIFICATION, SOS_API_SECURITY_TOKEN and SOS_ORGANIZATION_UID as appropriate.
Keep secrets in your CI secret store. See CI/CD Pipeline Setup.
If you use the Node.js SDK directly, update it and check how it authenticates. Some SDK paths still fetch organization credentials
internally even when initialized with an account token. Do not rely on Organization.createApiV1() or automatic organization-credential
discovery. Configure a supported organization token explicitly, or use supported account/JWT authentication with the organization UID for
the endpoints you call. Test the actual workflow; upgrading the package alone does not remove this dependency.
Organization API compatibility
Organization responses no longer expose the stored permanent organization secret. For eligible organization Owners and Managers,
GET /v1/organization/{uid} can temporarily return a restricted, 30-minute CLI capability in oauthClientSecret. It is not a permanent
API token and must not be saved as one. Older clients may fail when it expires.
Existing stored legacy organization pairs remain temporarily accepted for migration. This compatibility is not a long-term interface. Migrate now rather than depending on it remaining available.
Timeline
| Milestone | Date |
|---|---|
| Announcement | November 19, 2026 |
| CLI v3 deprecated | January 31, 2027 |
Guides
We want your feedback
If this change impacts your workflow, please reach out via support ticket.