Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tryardent.com/llms.txt

Use this file to discover all available pages before exploring further.

Any Postgres instance with logical replication enabled works with Ardent. Want Claude to handle this? Paste this into Claude Code or Cursor: 
Check if my Postgres database is ready to connect to Ardent.
My connection string: [paste here]

Verify:
1. The host is reachable and credentials work
2. wal_level is set to logical (SELECT current_setting('wal_level'))
3. The user has the REPLICATION privilege
4. At least 1 replication slot is available (SELECT * FROM pg_replication_slots)

Tell me exactly what to fix if anything fails, then run:
ardent connector create postgresql '<connection-string>'
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'
Use single quotes around the URL in the shell so passwords or query parameters are not mangled.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.