+4
Daily
8,826
stars
384
forks
29
watchers
2,817
prs
908
issues
54
releases
README
Atlas - Manage Your Database Schema as Code
Atlas is a language-agnostic tool for managing and migrating database schemas using modern DevOps principles.
It offers two workflows:
- Declarative: Similar to Terraform, Atlas compares the current state of the database to the desired state, as
defined in an [HCL], [SQL], or [ORM] schema. Based on this comparison, it generates and executes a migration plan to
transition the database to its desired state.
- Versioned: Unlike other tools, Atlas automatically plans schema migrations for you. Users can describe their desired
database schema in [HCL], [SQL], or their chosen [ORM], and by utilizing Atlas, they can plan, lint, and apply the
necessary migrations to the database.
Supported Databases
PostgreSQL ·
MySQL ·
MariaDB ·
SQL Server ·
SQLite ·
ClickHouse ·
Redshift ·
Oracle ·
Snowflake ·
CockroachDB ·
TiDB ·
Databricks ·
Spanner ·
Aurora DSQL ·
Azure Fabric
Installation
macOS + Linux:
bash
curl -sSf https://atlasgo.sh | sh
Homebrew:
bash
brew install ariga/tap/atlas
Docker:
bash
docker pull arigaio/atlas
NPM:
bash
npx @ariga/atlas
See installation docs for all platforms.
Install the skills
Claude Code:
bash
claude plugin marketplace add ariga/atlas
claude plugin install atlas@ariga
Codex, Cursor, or GitHub Copilot, from the root of your repository:
bash
npx skills add ariga/atlas -a codex -y or: -a cursor, -a github-copilot
[!NOTE]
The Atlas website has the most up-to-date version
of these skills: they are maintained there and copied to skills/ from time to time.
Key Features
- Declarative schema migrations: The atlas schema command offers various options for inspecting, diffing, comparing, planning and applying migrations using standard Terraform-like workflows.
- Versioned migrations: The atlas migrate command provides a state-of-the-art experience for planning, linting, and applying migrations.
- Schema as Code: Define your desired database schema using [SQL], [HCL], or your chosen [ORM]. Atlas supports 16 ORM loaders across 6 languages.
- Security-as-Code: Manage roles, permissions, and row-level security policies as version-controlled code.
- Data management: Manage seed and lookup data declaratively alongside your schema.
- Cloud-native CI/CD: Kubernetes operator, Terraform provider, GitHub Actions, GitLab CI, ArgoCD, and more.
- Testing framework: Unit test schema logic (functions, views, triggers, procedures) and migration behavior.
- 50+ safety analyzers: Database-aware migration linting that detects destructive changes, data-dependent modifications, table locks, backward-incompatible changes, and more.
- Multi-tenancy: Built-in support for multi-tenant database migrations.
- Drift detection: Monitoring as Code with automatic schema drift detection and remediation.
- Cloud integration: IAM-based authentication for AWS RDS and GCP Cloud SQL, secrets management via AWS Secrets Manager, GCP Secret Manager, HashiCorp Vault, and more.
Top issues
#1523Existing types in schema.sql are preventing new migrations to be generated22 comments · 2023-03-09#3372Bug: DNS is not being resolved in env.url18 comments · 2025-02-10#3266mssql: table partition support16 comments · 2024-12-16#647Support for permissions16 comments · 2022-03-11#2612terraform migration: "atlas_schema_revisions" table created in "public" schema14 comments · 2024-03-13#2015Atlas migrate diff picking random order for GORM models12 comments · 2023-08-23#3763uuid macro fails atlas schema lint10 comments · 2026-08-04#3625Support for pgbouncer in transaction mode10 comments · 2025-12-02
Discussions
#3775CI/CD Project pricing is hard to justify on a pre-public project1 comments · 2026-08-16#3774Compare dev and prod databases to create migration file1 comments · 2026-08-16#3651Clickhouse and on cluster statements2 comments · 2026-01-23#3620Run atlas sqlite migration in unit test1 comments · 2025-11-15#3611Correct email address1 comments · 2025-10-27#3582Using Atlas declarative approach with Drizzle ORM schema definitions and handling multi-developer testing environments1 comments · 2025-08-22#3581Why still use an ancient version of golang.org/x/oauth?1 comments · 2025-08-22#3551Down Migrations aren't a Myth 🧯2 comments · 2025-07-16
Latest release
v1.3.0 v1.3.0 2026-08-02We're excited to announce Atlas v1.3 🎊 This release delivers on a promise we made in v1.2: the security graph is now live in Atlas Cloud, mapping your entire database attack surface. It also introduces Atlas Scripts for running data operations as code, safer and faster migrations, and a new command group for working with the Atlas Registry from the CLI. Here is what you can find in this release: - Security Graph for Databases - Map your entire database attack surface: permissions, misconfigurations, and CVEs across every object, with severity tiers and blast-radius tracing. - Atlas S