A professional migration tool to move from CasaOS to ZimaOS. It supports both online and offline migration modes and helps complete full application migrations.

CTOZ provides Online Migration (both CasaOS and ZimaOS are online) and Offline Migration (only one is online). It downloads data from the source system and imports it into the target system to assist in completing full application migration.

If you have a CasaOS device and find ZimaOS more suitable, you may want to switch. This tool helps you migrate applications and data from CasaOS to ZimaOS with minimal friction.

This tool migrates everything under the application configuration (AppData) directory and the application YAML/Compose files. Applications will be re-installed on ZimaOS.

• All contents under AppData (user data and configurations)
• Application definitions (Docker Compose / YAML)

# Clone repository
git clone https://github.com/LinkLeong/ctoz.git
cd ctoz

# Start services
docker-compose up -d

# Run container
docker run --rm -p 8080:8080 a624669980/ctoz:latest

• Online Migration: Direct connection between source and target, real-time transfer
• Offline Migration: Export a package first, then import to the target
• Live Monitoring: Real-time status updates and logs via WebSocket
• Smart Caching: Import status query caching for faster responses
• Web UI: Modern, easy-to-use web interface

• AppData upload always succeeds. If a folder already exists on ZimaOS, a numeric suffix will be appended.
• For Docker installation failures, download the YAML and import manually on ZimaOS.

• Import status aggregates all apps and may take time. Please wait.
• Query performance is optimized. Repeat queries will use cache for faster response.

cd backend
go mod tidy
go run cmd/main.go

cd frontend
npm install
npm run dev

After starting the service, open: http://localhost:8080/info

Issues and PRs are welcome!

Hey, do you like this kind of project?

To make sure we can keep working on free and open-source projects like this, please consider becoming a ❤️ Sponsor or support us via ☕ Ko-fi.

MIT License