Skip to main content

2026-11-19 - CLI v3 Deprecation: Upgrade and Sign In Again by January 31, 2027

info

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​

  1. Update the CLI: npm install -g @signageos/cli@latest
  2. Check the version: sos --version
  3. Run sos login again and complete the browser sign-in for the correct region. Repeat for each profile you use.
  4. 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​

MilestoneDate
AnnouncementNovember 19, 2026
CLI v3 deprecatedJanuary 31, 2027

Guides​

We want your feedback​

If this change impacts your workflow, please reach out via support ticket.