US Region (US1)
The signageOS platform is available in a dedicated United States region ("US1"). The US1 region runs the full signageOS cloud stack on infrastructure hosted in the United States, so all device data, content, and platform services stay within the US.
US1 is a fully separate environment from the default region: it has its own console, API, user accounts, organizations, and device fleet. An account or organization from the default region does not exist in US1 — you register and provision devices directly in US1.
Where to Log In
| Service | URL |
|---|---|
| Console (Box) | https://box.us1.signageos.io |
| REST API | https://api.us1.signageos.io |
| Developer documentation | https://developers.signageos.io |
Credentials are region-specific. Create your US1 account on the login page above, or accept an invitation from your US1 organization administrator.
Core Apps for US1 Devices
Devices in the US1 region must run the US1 build of the signageOS Core App. US1 builds are functionally identical to the standard release but connect to the US1 cloud by default. Install them from the links below.
The links below always serve the latest published US1 Core App version.
Samsung Tizen
- URL launcher address (landscape):
https://t.us1.signageos.io - URL launcher address (portrait):
https://t.us1.signageos.io/portrait - Kiosk package: https://t.us1.signageos.io/kiosk/signageoskiosk.zip
LG webOS
- IPK (SI Server or remote installation): https://w.us1.signageos.io/w.ipk
- ZIP (USB installation): https://w.us1.signageos.io/w.zip
BrightSign
- Core App (
autorun.zipfor microSD installation): https://b.us1.signageos.io/autorun.zip
Provisioning steps are otherwise the same as in the standard device provisioning guides — only the download URLs above differ.
CLI Setup for the US1 Region
The signageOS CLI works against US1. All commands (sos applet upload, sos applet start, sos applet build, sos timing, sos device, …) use the region configured in your profile.
Region selection requires CLI version TBD or newer: npm install -g @signageos/cli@latest
Interactive setup
Log in and select the us1 region when prompted:
sos login
The command asks you to select a region (default or us1), saves the connection settings for the selected region into ~/.sosrc, and then authenticates you in the browser. All subsequent commands target US1.
CI and non-interactive environments
Set environment variables instead — they take precedence over any stored profile:
export SOS_API_URL="https://api.us1.signageos.io"
export SOS_API_IDENTIFICATION="<your US1 organization token id>"
export SOS_API_SECURITY_TOKEN="<your US1 organization token secret>"
Generate the organization token in the US1 console, not in the default-region console.
Multiple regions side by side
Keep a separate profile per region and switch with the global --profile option (or the SOS_PROFILE environment variable):
sos --profile us1 login # configure once: select the us1 region and authenticate
sos --profile us1 applet upload # use per command
Known Limitations
| Area | Status |
|---|---|
| Samsung SSSP (pre-Tizen displays) | Not supported in US1. SSSP devices run legacy device software that cannot be provisioned automatically in this region. |
| Packages | Not available yet. |
| Whitelabel / custom domains | Not self-service yet. Custom domains for app delivery can be set up manually on request — contact signageOS support. |
| Content Guard | Not available yet. |
| One region per device | A device must be provisioned in exactly one region. Provisioning the same device in both the default region and US1 causes its configuration to switch back and forth between the two clouds. A permanent safeguard is in development. |
Network Requirements
Devices and operators connecting to US1 need access to these endpoints, in addition to the global endpoints listed in Network Requirements For Ports And Domains:
| Purpose | Domain | Protocol | Port |
|---|---|---|---|
| Console | box.us1.signageos.io | https | 443 |
| REST API | api.us1.signageos.io | https | 443 |
| Device gateway | gateway.us1.signageos.io | ws(s), http(s) | 443/80 |
| Content, applets, Core Apps (CDN) | static.us1.signageos.io | http(s) | 443 |
| Core App installation shortcuts (optional) | t.us1.signageos.io, w.us1.signageos.io, b.us1.signageos.io | http(s) | 443 |
| Device uploads (screenshots, logs) | upload.us1.signageos.io | http(s) | 443/80 |
| Remote debugging | weinre.us1.signageos.io | http(s) | 443 |
| Remote desktop | remote-desktop.us1.signageos.io | http(s) | 443 |
| Authentication | auth0.us1.signageos.io | https | 443 |
| Global device configuration (shared by all regions) | config.signageos.io | http(s) | 443/80 |