> ## Documentation Index
> Fetch the complete documentation index at: https://docs.powersync.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PowerSync Dashboard

> Use the PowerSync Dashboard to manage instances, configure Sync Streams, and monitor usage.

The PowerSync Dashboard is available in [PowerSync Cloud](https://www.powersync.com/pricing) (our cloud-hosted offering) and provides an interface for managing your PowerSync organization, projects, instances, and account settings.

The dashboard is available here: [https://dashboard.powersync.com/](https://dashboard.powersync.com/)

### Hierarchy: Organization, project, instance

* After successfully [signing up](https://accounts.powersync.com/portal/powersync-signup?s=docs) for PowerSync Cloud, your **PowerSync account** is created.
* Your account is assigned an **organization** on the [Free pricing plan](https://www.powersync.com/pricing).
* To get started, you'll need to create a **project** in your organization.

<Frame caption="Empty projects view - create your first project">
  <img src="https://mintcdn.com/powersync/m6fGEiJuEsLbVG1i/images/usage/tools/dashboard-org-level.png?fit=max&auto=format&n=m6fGEiJuEsLbVG1i&q=85&s=434097a4aa26e4c7ab15626fca73bdb2" alt="" width="1985" height="1129" data-path="images/usage/tools/dashboard-org-level.png" />
</Frame>

When you click "Create a New Project", you can opt to create a *Development* and *Production* **instance** automatically for that project (recommended). An instance runs a copy of the [PowerSync Service](/architecture/powersync-service) and connects to your [backend source database](/configuration/source-db/connection). You can also update region for each instance from US to EU, JP (Japan), AU (Australia) or BR (Brazil).

<Frame caption="Create new project dialog">
  <img src="https://mintcdn.com/powersync/m6fGEiJuEsLbVG1i/images/usage/tools/dashboard-create-project.png?fit=max&auto=format&n=m6fGEiJuEsLbVG1i&q=85&s=11c2e804437f14be425021ecf02b9c1c" alt="" width="1980" height="1120" data-path="images/usage/tools/dashboard-create-project.png" />
</Frame>

Here is an example of how this hierarchy might be used by a customer:

* **Organization**: Wanderlust Inc.
  * **Project**: Wanderlust Tracker
    * **Instance**: Development
    * **Instance**: Production

### Dashboard Overview

The PowerSync Dashboard is organized into three main levels, each providing different functionality:

1. **Organization Level** - Manage projects, team members, organization and billing settings
2. **Account Level** - Manage your personal account settings and access tokens
3. **Project & Instance Level** - Configure and monitor your PowerSync instances

### Organization Level

URL structure: `https://dashboard.powersync.com/org/{orgId}/projects`

At the organization level, you can manage your PowerSync projects and organization-wide settings. Navigate to your organization to access:

* **Projects** - View all projects in your organization, create new projects, and manage project settings
* **Team** - Invite team members to your organization, manage user roles, and remove access
* **Plans & Billing** - View or update your PowerSync subscription plan and manage billing details
* **Plan Usage** - Monitor usage metrics across all projects in your organization for the current billing cycle
* **Settings** - Update the organization name

### Account Level

URL structure: `https://dashboard.powersync.com/account/me`

At the account level, you can manage your personal account settings:

* **Account Details** - View your account email and name
* **Security** - Reset your password and configure multi-factor authentication (MFA)
* **Access Tokens** - Create and manage personal access tokens for use with the [CLI](/tools/cli)

### Project & Instance Level

URL structure: `https://dashboard.powersync.com/org/{orgId}/project/{projectId}/{instanceId}/{view}`

When you navigate to a specific instance, you'll see a left sidebar with various views for configuring and monitoring that instance:

* **Health** - Overview of its connection health, deploy history, replication status, and recently connected clients
* **Database Connections** - Configure and manage the source database connection
* **Client Auth** - Configure authentication settings
* **Sync Streams / Sync Rules** - Edit, validate, and deploy your sync config.
* **Sync Test** - Test your Sync Streams (or legacy Sync Rules)
* **Client SDK Setup** - Generate the [client-side schema](/intro/setup-guide#define-your-client-side-schema) based on your deployed [Sync Streams](/sync/streams/overview) or [Sync Rules](/sync/rules/overview)
* **Write API** - Resources for exposing the write API endpoint
* **Logs** - View replication and service logs
* **Metrics** - Monitor usage metrics and performance
* **Settings** - Advanced options such as updating the [Service version](#advanced-service-version-locking), [compacting or defragmenting buckets](/maintenance-ops/compacting-buckets), and options for deprovisioning and destroying your instance

In the top bar, you'll see a "Connect" button that provides quick access to your instance URL and other resources for connecting to your instance.

<Frame caption="Dashboard top navigation bar showing the Connect button">
  <img src="https://mintcdn.com/powersync/m6fGEiJuEsLbVG1i/images/usage/tools/dashboard-connect-button.png?fit=max&auto=format&n=m6fGEiJuEsLbVG1i&q=85&s=a8ebb99e186f5e1e0582ecb5702b4529" alt="" width="717" height="82" data-path="images/usage/tools/dashboard-connect-button.png" />
</Frame>

#### Common Tasks

Here are some of the most common tasks you'll perform in the dashboard:

* **Edit and deploy Sync Streams / Sync Rules** - Select your project and instance and go to the **Sync Streams** (or legacy **Sync Rules**) view to edit your sync config, then click **"Validate"** and **"Deploy"** to deploy
* **Generate development token** - Navigate to the **Client Auth** and ensure the **Development tokens** setting is checked. Click the "Connect" button in the top bar and follow instructions to generate a [development token](/configuration/auth/development-tokens).
* **Launch the Sync Diagnostics Client** - Navigate to the **Sync Test**, generate a development token and click "Launch" to launch the [Sync Diagnostics Client](/tools/diagnostics-client).
* **Copy your instance URL** - Click **Connect** in the top bar and copy the instance URL from the dialog.
* **Generate client-side schema** - Click the **Connect** button in the top bar to generate the [client-side schema](/intro/setup-guide#define-your-client-side-schema) based on your deployed [Sync Streams](/sync/streams/overview) or [Sync Rules](/sync/rules/overview) in your preferred language
* **Monitor instance health** - Navigate to the **Health** view to see an overview of your instance status, database connections, and recent deploys
* **View logs** - Navigate to the **Logs** view to review replication and client sync logs
* **Monitor metrics** - Navigate to the **Metrics** view to track usage metrics

#### Advanced: Service Version Locking

Customers on our [Team and Enterprise plans](https://www.powersync.com/pricing) can lock their PowerSync Cloud instances to a specific version of the PowerSync Service. This option is available under your instance settings.

Versions are specified as `major.minor.patch`. When locked, only new `.patch` releases will automatically be applied to the instance.

**Downgrade limitations:** Not all downgrade paths are available automatically. If you need to downgrade to an older version, please [contact our team](/resources/contact-us) for assistance.
