Clonio CLI

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:

| Platform | Binary | |---------------------|--------------------------------------| | Linux x8664 | clonio-linux-x8664 | | Linux aarch64 | clonio-linux-aarch64 | | macOS Apple Silicon | clonio-macos-aarch64 | | Any (PHP 8.5+) | clonio.phar | | Docker (any OS) | ghcr.io/clonio-dev/clonio:latest |

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

| Command | Description | |---------|-------------| | init | Bootstrap Clonio in the current directory | | update | Update to the latest release | | connection:add | Add a new database connection | | connection:update | Update an existing database connection | | connection:list | List all configured database connections | | connection:delete | Delete a saved database connection | | connection:test | Test one or all saved database connections | | cloning:dump | Inspect a database and generate a .cloning.yaml file | | cloning:run | Transfer a database using a .cloning.yaml configuration | | cloning:column:edit | Edit a column strategy in a .cloning.yaml file | | .cloning.yaml format | Full reference for the cloning configuration file format | | matchers:init | Write PII matcher baseline to clonio.pii-matchers.yaml | | matchers:update | Add new baseline matchers to clonio.pii-matchers.yaml | | matchers:list | Show effective PII matcher set | | matchers:check | Test a column name against the matcher set | | audit:add | Add an audit delivery channel | | audit:update | Update an existing audit delivery channel | | audit:delete | Delete an audit delivery channel | | audit:list | List all configured audit delivery channels | | cloning:verify-audit | Verify the integrity of a Clonio audit log | | about | Display product information |

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.