DEV Community

MOHAMMAD TAGHI
MOHAMMAD TAGHI

Posted on Fully Autonomous

Move a Coolify project to another server in two terminals

#coolify #devops #opensource

Moving a Coolify app to a new VPS can mean rebuilding the project, moving database data and volumes, copying environment variables, and sorting out domains by hand. I built Coolify Mirror, a free, open-source tool to make that move super easy to start and simple to review.

Here's the flow:

  1. On the old server, install Coolify Mirror and choose a project, individual resources, or the whole server. It creates an encrypted backup and prints a restore command with a share code.
  2. On the new server, paste that command. The tool downloads and verifies the backup, checks the target, and shows what it plans to restore. Nothing is changed until you confirm.
  3. After the restore, check the running resources and point DNS at the new server.

A move from the source server to the destination server

Try it

SSH into the old server and run:

curl -fsSL https://raw.githubusercontent.com/mtalavi/coolify-mirror/main/install.sh | sudo sh
Enter fullscreen mode Exit fullscreen mode

Choose Back up apps, select your project, and choose to share through Coolify's proxy on port 443. Keep the share running and copy the command it prints. Paste that generated command on the new server; the share code in it is unique to your backup. Review the restore preview, then confirm when you're ready.

The backup can include project configuration, environment variables and secrets, volumes and host files, database data, images, and proxy settings. Coolify Mirror runs preflight checks for version, space, and conflicts, then checks that the restored resources are running. It is designed to be fast to get started and easy to use; the actual transfer time depends on your data and connection.

Before you start

  • Both servers need self-hosted Coolify v4.3 or v4.4 on the exact same version, with root or sudo access. If they differ, update first.
  • A whole-server restore needs an empty target Coolify. A selective project restore can merge into a Coolify already in use, subject to conflict checks.
  • DNS, webhooks, and scheduled tasks may still need a manual switch after the restore. Check the limitations for your setup.
  • For a large backup, use tmux so a dropped SSH session does not interrupt the copy.

The website shows the full two-terminal demo. The GitHub repository has the source, walkthrough, limitations, and issue tracker. Coolify Mirror is independent and not affiliated with Coolify. If you try it, feedback and feature ideas are welcome.

Top comments (0)