README

Clonio transfers your production database to your test and dev environments with automatic anonymization, fake data generation, and full audit trails.

It is free and open source for individuals and NGOs. See clonio.dev for more information.

Installation

Download the binary for your platform from the latest release:

The platform binaries are fully self-contained — no PHP required. The PHAR requires PHP 8.5 on the target machine (php clonio.phar) but is smaller and works on any platform.

Rename it, make it executable, and optionally move it to your PATH:

# Linux
mv clonio-linux-x86_64 clonio
chmod +x clonio
mv clonio /usr/local/bin/clonio

# macOS
mv clonio-macos-aarch64 clonio
chmod +x clonio
mv clonio /usr/local/bin/clonio

No PHP installation required — the binary is fully self-contained.

macOS note: The binary is currently unsigned. macOS may block it with a Gatekeeper warning. To allow it, run:

xattr -d com.apple.quarantine clonio

See docs/code-signing.md for the full signing setup once an Apple Developer account is available.

Docker

No install required — run Clonio as a one-off container against your current directory:

docker run --rm -v "$(pwd)":/workspace \
  ghcr.io/clonio-dev/clonio:latest --version

Multi-arch image (linux/amd64, linux/arm64). See docs/docker-distribution.md for the full tag scheme, recipes, and CI pinning guidance.

Composer (dev dependency)

Clonio can also be required as a dev dependency in any PHP project:

composer require --dev clonio-dev/clonio-cli

This makes vendor/bin/clonio available with the exact release version. See docs/composer-distribution.md for details, CI examples, and PHP version requirements.

Commands

Development

See docs/development.md for setup, local builds, testing, and linting.

Releasing

See docs/releasing.md for the step-by-step release process.

Contributing

See CONTRIBUTING.md.