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 x86_64	clonio-linux-x86_64
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.

---

Security

Store secrets as env:NAME references (the default), run transfers from production only in CI, and feed test and dev from anonymized data. See docs/security.md.

---

Commands

Command	Description
init	Bootstrap Clonio in the current directory
key:rotate	Replace the encryption key and re-encrypt stored secrets
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.

composer test                # Full suite: type coverage, unit tests, PHPStan, lint
composer test:mutate -- --path=app/Services/Cloning/FrameworkTableCatalog.php
                             # Mutation testing for one class or directory
composer test:mutate:all     # Whole app, fails below 100%

Arguments after -- go to Pest, e.g. --parallel, --min=80, --no-cache or a test file to limit the run. See Mutation testing.

---

Releasing

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

---

Contributing

See CONTRIBUTING.md.