PowerSync Cloud Instances

​

Create a PowerSync Instance

• Dashboard
• CLI

When creating a project in the PowerSync Dashboard, Development and Production instances of the PowerSync Service will be created by default. Select the instance you want to configure.If you need to create a new instance, follow the steps below.

1. In the dashboard, select your project and open the instance selection dropdown. Click Add Instance.

2. Give your instance a name, such as “Production”.
3. [Optional] You can change the default cloud region from US to EU, JP (Japan), AU (Australia) or BR (Brazil) if desired.
   • Note: Additional cloud regions will be considered on request, especially for customers on our Enterprise plan. Please contact us if you need a different region.
4. Click Create Instance.

Install the PowerSync CLI (requires Node.js/npm), then log in and scaffold the config directory:

npm install -g powersync
powersync login
powersync init cloud

This creates a powersync/ directory with service.yaml (instance name, region, connection, auth) and sync-config.yaml (sync config). Edit powersync/service.yaml to set your instance name and region.Then create the instance and link the directory to it:

powersync link cloud --create --project-id=<project-id>

Find your project ID in the PowerSync Dashboard URL, or run powersync fetch instances after logging in.

​

Configure Your Instance

1. A connection to your source database. See Source Database Connection.
2. Client authentication. See Authentication Setup. When getting started, you can use temporary development tokens instead of setting up a full auth provider.
3. A sync configuration defining what data syncs to which clients, written as Sync Streams.

• PowerSync Dashboard documentation
• PowerSync CLI documentation