Skip to main content
Any Postgres instance with logical replication enabled works with Ardent.
1

Enable logical replication

Set wal_level = logical in your postgresql.conf:
ALTER SYSTEM SET wal_level = 'logical';
Then restart Postgres for the change to take effect.
2

Check replication slots

Make sure you have at least 1 available replication slot:
SELECT * FROM pg_replication_slots;
3

Grant replication permissions

Ensure your user has the REPLICATION privilege:
ALTER USER your_user WITH REPLICATION;
4

Connect your database

ardent connector create postgresql postgresql://user:password@your-host:5432/mydb
Ardent will verify your setup and begin replicating your database. This may take a few minutes depending on data size.
Not sure if your database is ready? Just run the command — Ardent checks all prerequisites during setup and tells you what’s missing.
5

Create your first branch

ardent branch create my-feature
Done. You now have an isolated copy of your database — schema, data, and all. The CLI returns a connection URL you can use anywhere.