FAQ

General

What is NGS? What is Synadia Cloud?

NGS is a global, multi-cloud, multi-geo NATS.io service.

Synadia Cloud allows you to monitor and manage Streams, Consumers, Accounts, Users, Imports, Exports and more on NGS.

You can sign up for a Synadia Cloud at https://cloud.synadia.com.

How can I use the Synadia Cloud API?

Once you have logged into Synadia Cloud, you can view the API Docs

You can authenticate to the Synadia Cloud API using a Personal Access Token as a Bearer Token.

The Control Plane Go SDK is also compatible with Synadia Cloud using the following settings to authenticate:

ctx := context.WithValue(context.Background(), syncp.ContextServerVariables, map[string]string{
 "baseUrl": "https://cloud.synadia.com",
})
ctx = context.WithValue(ctx, syncp.ContextAccessToken, "your-personal-access-token")

NATS Accounts and Users

How does Synadia Cloud store and use NATS Account and User Keys?

Synadia Cloud encrypts all NATS Account and User keys using 256-bit encryption.

Root NATS Account Keys never leave the application.

Programmatic NATS Account Signing Keys are shown to the end-user once when they are Created, and once when they are Rotated. All other NATS Account Signing Keys never leave the application.

NATS User Keys are included in the Credentials File every time it is downloaded.

How can I import Accounts and Users from NSC?

The Synadia Control Plane CLI can be used to Import from NSC.

Imported Accounts must have limits set that fit into your Team's plan.

When using the Control Plane CLI, set the --server flag or set the SCP_SERVER environment variable to https://cloud.synadia.com.

Can I manage Accounts and Users created in Synadia Cloud with NSC?

No. Synadia Cloud only supports managing Accounts and Users that were created in Synadia Cloud with its UI and API.

Migrating NGS Accounts from app.ngs.global

NGS Accounts that were created on app.ngs.global will be migrated to Synadia Cloud starting on January 24, 2024. This will be a non-disruptive migration.

How will I know when my account has been migrated to Synadia Cloud?

We will email users after their account has been migrated to Synadia Cloud.

How can I prepare for the migration

Sign up for a Synadia Cloud account using the same email address that you used to sign up with on app.ngs.global. Once the migration has been completed, your app.ngs.global Accounts will appear in Synadia Cloud.

After my account has been migrated, will I still use NSC to manage it?

Yes. All accounts imported from app.ngs.global will still be managed using NSC until they are converted to Synadia Cloud management.

How do I convert my migrated account from NSC management to Synadia Cloud management

Use the Synadia Control Plane CLI to Import your account from NSC. When using the Control Plane CLI, set the --server flag or SCP_SERVER environment variable to https://cloud.synadia.com

Once an account is converted from NSC management to Synadia Cloud management, it cannot be changed back

I still have questions about the migration

Please ask questions in the #ngs channel of the nats.io Slack, or email them to ngs-migration@synadia.com

FAQ