Step 1: Start Bytebase

This quick start takes you from an empty workspace to a reviewed schema change and a query. Choose how you want to run Bytebase below — the remaining steps are the same.

Bytebase Cloud
Self-Host with Docker

No installation required, and no database of your own needed to start.

Sign in at cloud.bytebase.com with Google, GitHub, or email, then click Create workspace.
Workspace setup opens on four screens. Name the workspace, choose what you want to do first, name your first project and keep Start with the sample database selected, then set up your team and click Finish.

Bytebase provisions a Sample Project Instance in that project — a PostgreSQL database loaded with the employee sample dataset — and opens the project’s Databases page while it syncs. The sample instance is available for seven days; see Sample Project Instance.

Already have a workspace, or no sample option? Bring your own database: Neon and Supabase spin up a free one in minutes; an RDS instance with a public IP works too. See Network requirements.

Run Bytebase locally with Docker. The setup wizard can create sample databases for you, so you don’t need to prepare a database yourself.

Install Docker if you don’t have it, and make sure it’s running.

Start Bytebase, then open localhost:8080.

docker run --rm --init \
  --name bytebase \
  --publish 8080:8080 --pull always \
  --volume ~/.bytebase/data:/var/opt/bytebase \
  bytebase/bytebase:latest

Fill in the fields and click Create admin account.
Workspace setup opens on four screens. Name the workspace, choose what you want to do first, name your first project and keep Start with the sample database selected, then click Finish. Bytebase creates hr_test on Sample Project Instance in that project and opens the project’s Databases page.

Introduction

Quick Start

Bytebase Essentials

Install

Connect Databases

Onboarding Guides