Installation

Prerequisites

clonit drives the native database tools, so the PostgreSQL client tools (pg_dump, pg_restore, psql) must be available in your PATH:

pg_dump --version
pg_restore --version
psql --version

Version Compatibility

Your local PostgreSQL tool versions should have a major version equal to or greater than the server versions you work with — pg_restore v15 cannot reliably restore to a PostgreSQL 16 server. Use clonit targets verify <name> to check compatibility for a specific target.

Install

Homebrew (macOS)

brew install joescharf/tap/clonit

Upgrade later with brew upgrade clonit. The macOS build is signed and notarized by Apple.

Direct download

Download the archive for your platform, extract it, and move the clonit binary onto your PATH (e.g. /usr/local/bin):

Platform	Download
macOS (universal)	clonit_Darwin_universal.zip
Linux (x86_64)	clonit_Linux_x86_64.tar.gz
Linux (arm64)	clonit_Linux_arm64.tar.gz
Windows (x86_64)	clonit_Windows_x86_64.zip

Docker

docker pull ghcr.io/joescharf/clonit:latest
docker run --rm ghcr.io/joescharf/clonit:latest version

The image’s default command is clonit serve (web UI on port 8484).

Verify

clonit version

This prints the version, commit hash, and build date. Next, head to the Quick Start.