Skip to content
zefıly

Connect any VPS or dedicated server to Zefily

You do not need a connected cloud account. Any virtual machine or dedicated server with a supported system can be enrolled in Zefily with one command. The agent then installs the baseline setup and the web stack you choose.

Before you start

  • Ubuntu 26.04 LTS or 24.04 LTS, or Debian 13 or 12, on amd64 or arm64, on a virtual machine or a dedicated server with systemd. Containers such as LXC or OpenVZ are not supported.
  • Root access, or sudo, on the server, and outbound HTTPS to Zefily.
  • At least 512 MB of memory (1 GB for WordPress or PHP sites) and 5 GB of free disk; ports 80 and 443 free for your sites.

Steps

  1. 1. Check the server

    Confirm the system and the resources above. Another control panel such as cPanel, Plesk or aaPanel, or a web server installed by hand, can hold ports 80 and 443 and will be shown as a blocker.

  2. 2. Add the server in Zefily

    In the panel open Servers and choose Add server. Give it a name and choose the web stack to install after setup: nginx or OpenLiteSpeed with PHP, a starter stack, or None (install later).

  3. 3. Run the install command as root

    Copy the install command and run it on the server with root or sudo. The command downloads the installer, checks its SHA-256 fingerprint before it runs, verifies the signed agent release and enrolls the server with a one-time token.

  4. 4. Or install over SSH

    If you do not want a terminal, choose Install over SSH instead on the same page. Enter the address and SSH port, read the host key, compare its fingerprint with the one shown, then enter the SSH user and a key or password. The password is used once and never stored.

  5. 5. Use cloud-init on a new cloud server

    For a new machine at a provider, paste the Cloud-init user data shown under the command into the provider's user-data field. The agent then installs itself on the first boot.

  6. 6. Choose how Zefily signs in

    On a server you add yourself, choose Add the keys I choose to root, or Leave SSH as it is. Keys are only ever appended to authorized_keys. Adding keys needs a recent agent release; the form says so when it is not out yet.

  7. 7. Wait for the pre-flight checks

    Within a minute the server shows Online. The pre-flight checks then cover systemd, the architecture, free disk, memory, virtualization, other panels and ports in use. Blockers and warnings appear on the server overview.

Verify it works

The server shows Online, the pre-flight checks show no blockers, and the baseline setup runs to the end: time sync, firewall, automatic security updates and SSH hardening are listed as done on the server page.

Troubleshooting

The enrollment token expired
Tokens are shown once and expire after a short time. Click New enrollment token on the server page and run the new command.
Pre-flight blocks the install
Read the blocker on the server overview. A panel or web server that Zefily did not install must be removed first; Zefily does not take over software it did not install.
The server is a container, not a VM
Containers such as LXC and OpenVZ are not supported. Use a virtual machine or a dedicated server instead.

Questions

Can I connect a server that is already in use?

Yes. Sites, databases, cron jobs and firewall ports from an earlier install are listed under Found on this server from an earlier install, and nothing is taken over until you adopt it.

Do I need to open an inbound port for the panel?

No. The agent connects out to Zefily over HTTPS. Ports 80 and 443 must be open only for the sites you host.

Does an older system work?

It connects, but the health score shows a warning and newer features may be missing. Use one of the supported systems for the smoothest setup.

Read next

Start on a server you own

Create your account, connect a server and follow the guide. The server stays yours: you pay your provider.

Start free

Black Friday & Cyber Monday

Before you go: lifetime plans are on sale

Pay once for a lifetime plan, or get 30% off the first year of any yearly plan.

Only 100 lifetime plans per plan. When they are gone, they are gone.

See the campaign

Amazing November

See the campaign →