Skip to content

Add a server

Your apps run on your own servers. To add one, you paste a single command into it, and it joins your other servers on a private network.

  • A Linux server with systemd, amd64 or arm64, from any provider: a Hetzner Cloud server, a DigitalOcean Droplet, a bare-metal box.
  • cgroup v2 to run builds. Every current distribution uses it. A server on cgroup v1 joins and runs apps, but its builds fail.
  • Ubuntu LTS, Debian 12–13 or Amazon Linux 2023 on a VM or bare metal for managed volumes. Anything else works without them.
  • A main disk of 30 GiB or more. Ployz keeps a quarter of the disk, at least 10 GiB, free for the system. On EC2, raise the root volume from its 8 GB default when you launch the instance.
  • Root, or a user that can run sudo.
  • Outbound internet access over IPv4, and a public IP address on at least one server so visitors can reach your apps. A server with only IPv6 needs NAT64 and DNS64; see IPv6-only servers.

You don't need Docker: Ployz installs it if it's missing.

From your own computer, signed in with ployz login:

ployz server add --command

It prints a line to paste on the server and an enrollment token beside it, then waits until the server joins. Paste the line in a shell on the server, as root or as a user with sudo, and paste the token when it asks. The prompt doesn't show what you paste, so the token never enters the server's shell history or process list. It takes one line: a paste of more than one line is refused and nothing is kept, so paste the token alone. The token works for 24 hours.

A script, such as cloud-init or ssh host '...', has no terminal to answer the prompt. There, export PLOYZ_ENROLL_TOKEN=pmet_… before the line: it keeps that variable through sudo. You can also pipe the token to sudo ployz server add --token-stdin after the install part of the line.

The server takes its hostname as its name, lowercased, with anything else a name can't hold, such as _ or ., turned into -; MY-SERVER becomes my-server. The line prints the name it chose. To choose another, run ployz server add --command --name web-1 and the printed line keeps the name. It keeps every other flag that shapes the server too, such as --storage, --label-add or --accepts-ingress. When it finishes, the server shows on the Servers page, ready for builds, services and web traffic. If it doesn't show up, see Troubleshooting servers.

While the server joins, the line prints Waiting for the Server's daemon to start…. The Ployz daemon restarts once after it enrolls, and a joining server catches up with your other servers, which usually takes under a minute. If it is still catching up after a minute, the line says so and names UDP 51820, which your servers use to reach each other. The wait gives up after 5 minutes.

Add more servers the same way, even at different providers. Each server after your cluster's first waits for a device you approved to sign its join, and you're told the code to approve; see Approve a join. Nothing moves onto a new server until you deploy; see Scaling.

An existing server admits a new one only under an approval from one of your approved devices. Until then it publishes nothing about the new server and doesn't share the cluster's key for sealed values. When you add a server from an approved computer with ployz server add, the CLI signs that approval with your device key.

A server that joins with the line from ployz server add --command or the dashboard has no approved device key, so its first join stops and names a 20-character code. Where you see it depends on how you added the server:

  • The install line from the dashboard. The code is in the Servers page. Open the server under Waiting: Last enroll names the code and the command to run. The server's own check-in loop doesn't print it.
  • ployz server add --command. The join command on the server prints the code.

From an approved computer, run the command with that code:

ployz device approve --join CODE

The code carries 100 bits of the server's identity and key fingerprint. Check the name, subnet and endpoints the CLI shows before it signs. It also lists the devices the server will trust, and the passkeys, if your cluster has any, with what a passkey can do. Then enroll the server again: choose Enroll for it in the dashboard, or run the same join command on the server again, with its token and options. A new admission needs an approval less than 15 minutes old. If the reply is lost, run the same command again to recover the stored capsule, even after the approval expires.

A new server refuses to join without an approval. If the approval goes missing on the way, the join stops and says the join approval carries no signature. Nothing changes on the server, so you can run the join again.

The new server takes its devices, the passkeys your admitting server trusts and its starting peers only from the approval. A passkey you approve on your cluster after that isn't added to a server that already joined; approve it there too. A server you add with ployz server add takes no passkeys from the approval, so approve each passkey there too. When you run ployz server add over SSH, the CLI also tells the new server which devices may sign that approval: your own, and with --standalone, those of the server it joins through. The new server refuses an approval signed by any other key, and trusts only the devices on that list that the approval also names. A join from the pasted line has no such list, so it trusts whichever devices the approval names.

When ployz server add reaches your cluster through Ployz Cloud, the CLI signs the approval for this computer's device alone, so the new server trusts only that device. The CLI names the other devices it left out; approve each one on the new server afterwards with ployz device approve. It also signs only for a cluster whose key you pinned with ployz device pin, and otherwise stops before it signs anything:

Server web-2 would join a Cluster this computer hasn't pinned, and the join was relayed through Ployz Cloud, which can't vouch for it. Pin your Cluster's key from one of its Servers, then add the Server again. Nothing was approved.

Run ployz device pin --connect ssh://USER@SERVER against one of your servers, then add the server again.

Each server checks new servers against its own devices before it accepts them as members or WireGuard peers. The servers in the starting set you signed with ployz device enforce are trusted without a join approval.

The admitting server doesn't publish the new server as a member until the new server proves it opened its capsule. Opening the capsule gives the new server the cluster's key for sealed values, and it answers with a confirmation only that key can produce. The join command sends the confirmation back the same way as the join, and the admitting server checks it before it publishes the new server. Until then, no server peers with it.

Join through Ployz Cloud without an approved device

Section titled “Join through Ployz Cloud without an approved device”

ployz server add root@HOST tells the new server which devices may approve its join: this computer's device. From a computer with no device key it has nothing to tell it, so it stops before the server joins:

web-2 can't join from here: this computer has no device key, so nothing tells the new Server which devices may approve its join. Run the same command from an approved device. Nothing was enrolled.

ployz server add --standalone can also take the devices of the server it joins through, when it reaches that server over SSH. With neither, it stops the same way:

web-2 can't join from here: this computer has no approved device key and reaches your Servers only through Ployz Cloud. Run it from an approved device, or add --connect ssh://USER@SERVER for a Server of the Cluster. Nothing was enrolled.

The line the dashboard or ployz server add --command gives you runs on the server itself and tells it no devices: it trusts whichever devices the approval names.

To start a Cluster outside Ployz Cloud, run this on the Linux server:

sudo ployz server add --standalone --context NAME

From your computer, give the server's SSH destination instead:

ployz server add --standalone root@HOST --context NAME

No Cloud sign-in or enrollment token is needed. A new or empty context gets its first Server and becomes the current context. To add another Server to a context that already has connections, use the SSH form. It joins the existing Cluster.

Run on the server, it approves no device: a device made there would be root's on that server, ride into every server you add later, and stay trusted after the server is gone. It prints the command that gives the server its first key from your computer:

ployz device approve --this-device --connect ssh://root@HOST

A new cluster's first server trusts no device or passkey, and Ployz Cloud can't give it one. Until you approve one on the server itself, it refuses deploys, restarts and other changes that need an approval. Approve one over SSH on that server:

  • From your computer, over SSH. Run ployz device approve --this-device --connect ssh://root@HOST, as in Approve a device.
  • From the dashboard only. Add a passkey under Account, then on the server run sudo ployz login and sudo ployz device approve --passkey CODE, as in Add a passkey. The server then trusts whichever key the dashboard named, wherever you installed it. Only the first way, with --connect, doesn't trust Ployz Cloud.
  • With a device request. Run ployz device request on your computer, then on the server run sudo ployz login and sudo ployz device approve CODE.

ployz server add --standalone root@HOST approves this computer's device on the new server for you. Servers you add later get your devices from the join approval. A server you add from the dashboard also gets the passkeys your first server trusts. One you add with ployz server add doesn't, so approve your passkey there too.

Before your first server, the Servers page shows one card instead of a list. Click Get install command and it makes a token that works for 24 hours and shows the install line with the token under it, then Shown once. Expires in 24h. Copy the token now: Ployz can't show it again. Paste the line in a shell on the server, as root or as a user with sudo, and paste the token when it asks. The card then says Listening for servers… until the first one checks in.

Adding a second server needs a device you approved: a passkey can't approve a join. Install the CLI, approve your device on your first server as in Your first server's first key. When you install the second server, its row under Waiting shows Last enroll with a code. Approve it with ployz device approve --join CODE, then choose Enroll for the server again. It trusts the passkeys your first server trusts, so your dashboard approvals work on it without another step.

Only an owner or admin, or Ployz support, can make a token. For a member, Get install command and Add servers say so instead.

Under Get install command, Use Cloudflare Tunnel instead of public ports opens two choices for the Cluster your first server starts. Leave it closed and the first server starts as it always did: ports 80 and 443 open, and your apps get addresses under your organization's free domain.

  • Cluster name is the name your services' private addresses end in, like .acme.ployz.internal. It starts as your organization's slug. Change it here, or later in Organization → Network.
  • Cloudflare Tunnel serves your apps through your own Cloudflare zone, so your servers never open ports 80 and 443. Turn it on, paste a Cloudflare API token with Zone Read, DNS Edit and Cloudflare Tunnel Edit, and click Find zones. Pick the zone, like example.com, and click Check. Ployz checks the token can set up the tunnel and that *.example.com is free, and creates nothing yet. The card says Ready for example.com.

Get install command waits until Cloudflare is ready. Turn the switch off, or close the section before it's ready, and the card says Without Cloudflare Tunnel, your servers open ports 80 and 443.

With Cloudflare ready, the install line starts your first server with ports 80 and 443 closed. Keep the tab open while it joins: the tab holds your token, and Ployz never stores it. Once the server joins, Ployz creates a tunnel named ployz-<your organization> and one *.example.com record, opens the tunnel on the server, drops the token, and the Servers page says Cloudflare Tunnel is set up on example.com. With no open ports to keep your apps answering meanwhile, Ployz then switches your web traffic to the tunnel by itself, and a deployment that is already running when it looks moves with it. Your apps get addresses like web-production.example.com. If that switch stops, Organization → Network says why, and Review and switch finishes it.

If setup stops, the Servers page says why. Try again runs it with the same token. Use public ports instead opens ports 80 and 443. A setup that fails once it has reached your server opens the ports instead, so your apps answer, and says so. If you closed the tab before the server joined, the Servers page says your apps aren't reachable yet: paste the token again to finish, or open the ports. A server whose ployz predates this can't start closed, and enrolling it says to update ployz or get an install command without Cloudflare Tunnel.

A Cluster remembers the doors you chose: ployz server add --ingress-closed and ployz ingress use record them on the Cluster. A server joins with them whichever way you add it, and a server that restarts doesn't start a tunnel connector the Cluster left closed. A server whose ployz is too old to follow them can't join a Cluster that is closed or uses the tunnel, with or without the ports. Adding it says to update ployz on it and run the join command again. A Cluster that never recorded its doors works as it did: new servers copy the doors the servers already run. So does one whose entry server runs an older ployz, when no server of the Cluster can record doors. When one can, ployz ingress use run through the older server records the doors on that one and goes on.

The bottom bar of an environment offers the same card under Add servers while you have no server. You can skip it and build your project first.

Once a server has joined, the card is gone. Rename the Cluster and switch between public ports and Cloudflare Tunnel in Organization → Network; see Cloudflare Tunnel.

Once you have a server, or one is waiting, make more tokens with Add servers:

  1. Go to Servers and click Add servers. While you have no server, the bottom bar of your environment offers it too.
  2. Name the token, or leave the name blank and Ployz picks one. Choose how long it works: 1 day, 7 days or 30 days.
  3. Click Create. The Shell tab shows the install line and the token under it, then Shown once. Expires in 24h. Copy the token now: Ployz can't show it again.
  4. Open a shell on the server, as root or as a user with sudo, and paste the line. When it asks for the Fleet Token, paste the token. The prompt doesn't show what you paste, so the token stays out of shell history and the process list. To put it in user data instead, take it from the cloud-init tab; it holds the same token. Not on Ubuntu, Debian or Amazon Linux, or can't run ZFS? See Start without ZFS.

The Add servers dialog with its install line and the token to paste

Run the same line, and paste the same token, on as many servers as you like while the token works. Each one installs Docker and Ployz and shows up under Waiting to join on the Servers page within seconds, in a tray above your other servers. The tray shows only while a server waits or enrolls. Its header counts the servers that are ready, preparing, blocked and offline, with a bar for the mix. New ones go to the bottom of the list, and the list never reorders while you look at it. When your very first server arrives ready, the tray names it and offers Enroll and Reject right in the header.

Select a waiting server and click Enroll to choose its name, storage and what it runs. You can enroll while it prepares. Only an owner or admin, or Ployz support, can enroll or reject servers. For a member, Enroll and Reject are disabled and say so. Follow Add many servers for the full review and enrollment flow.

Each row shows the server's name and operating system, the IP address Ployz Cloud saw it check in from and its provider, its CPU, memory and main disk size, and its status. Installing Docker means it is still getting ready, and Ready means Docker is in place. Building ZFS under Ready means its ZFS build is still running, and an enrollment with ZFS volumes waits for it. Blocked rows say what is wrong with the server, in the server's own words, such as Disk is 20 GiB. Ployz needs 30 GiB. A server that still belongs to another organization is blocked until you run ployz server rm for it there. A server where another program holds UDP port 51820, which Ployz needs for WireGuard, is blocked and names that program, for example UDP port 51820 is in use by avahi-daemon (pid 812). Free the port and the block clears on its next check-in. Offline means it stopped checking in. You can't select a blocked server. Once more than ten servers wait, filter the list by readiness, provider and token, or search by name or IP address.

Servers you enroll move to Enrolling in the same tray, with the step each one is on, until they join.

Above your servers, Fleet counts how many are online, building, offline and unknown, and how many need an upgrade.

Click a waiting row to see the server in full, with its CPU, memory, disks, Docker, the storage it would get, its open ports and anything blocking it. Reject there turns the server away: it stops checking in, and asking again with the same token gets it turned away.

Tokens on the Servers page lists your Fleet Tokens with how many servers wait on each and how many joined, when each expires and when it was last used. Revoke asks you to confirm, then stops a token at once and drops the servers still waiting on it; the message after says how many. Servers that already joined stay.

A Fleet Token lets servers register under Waiting for you to review and enroll together. See Add many servers. You can also make a token from your computer:

ployz server token create --expires 7d

It prints the token once, and an install line for the release of the ployz CLI you ran. Run that line on each server and paste the token when it asks:

curl -fsSL https://ployz.sh | sudo sh -s -- VERSION --enroll

Keep the version it names. Without one, the script installs the stable release, which may not match your Ployz Cloud. With --json, the token is in fleet_token.token and the line in install.

  • Servers wait for you. A server that runs the line checks in under Waiting until you enroll it from Servers.
  • It lasts 24 hours by default. --expires takes 1d, 7d or 30d.
  • Expiry and revoke stop servers that haven't joined. Revoke drops waiting servers at once. After expiry, each waiting server is dropped when it next checks in. Enrollments already started finish, and servers already in stay.
  • Only your login makes or revokes one. An organization token can't.

List your tokens, and revoke one by name:

ployz server token ls
ployz server token revoke amber-falcon

The Tokens page on Servers shows the same list. Revoking also drops the servers still waiting on that token. The prompt keeps the token out of shell history, sudo logs and the server's process list. See Install with a Fleet Token for cloud-init and rerun outcomes.

To put managed volumes on a spare disk, name it when you enroll the server:

sudo ployz server add --storage zfs:/dev/disk/by-id/virtio-data

A by-id path stays stable when the kernel renames disks after a reboot. You can also name a kernel path such as zfs:/dev/vdb. The disk must be an empty whole disk. Ployz refuses a disk with a filesystem, a partition table, partitions, or mounts. It creates the ployz-device pool on the selected disk. Retrying installation on the same disk also imports an exported pool before checking whether the disk is empty. After a reboot, a volume lookup, mount, or storage request imports that pool again. Ployz records device ownership before serving volumes, including when the operating system already imported the pool. If the device is unavailable, storage operations fail instead of creating a replacement pool on the main disk.

With --storage zfs and no device, Ployz prepares ZFS and creates a file-backed pool on the main disk when you deploy the first managed volume. A failed named-device attempt that creates no pool leaves this option available. Existing file-backed storage takes priority over pools found on attached disks. If a previously owned device pool is missing, preparation refuses instead of forgetting it. For installer-only use, ployzd install --storage zfs:/dev/vdb accepts the same device form.

The command sets up managed volumes with ZFS, so every volume gets a storage limit. ZFS needs:

  • Ubuntu LTS with its stock kernel, Debian 12 or 13, or Amazon Linux 2023.
  • Secure Boot off, on Debian and Amazon Linux.
  • A VM or bare metal, not an OpenVZ or unprivileged LXC container.
  • Free space on the main disk for your volumes.

On Ubuntu, ZFS comes ready-made. On Debian and Amazon Linux, the server builds it, so the command takes longer: 15–20 minutes on a 2-vCPU Amazon Linux Server, a few minutes on Debian. The build tools stay installed, so ZFS can be rebuilt when the kernel updates.

If your server can't run ZFS, put PLOYZ_SKIP_ZFS=1 after sudo in the install line, as in curl -fsSL https://ployz.sh | sudo PLOYZ_SKIP_ZFS=1 sh -s -- VERSION --enroll. With ployz server add, add --storage none.

The server then shows Docker only. If none of your servers has managed volumes, every new volume, a database's included, fails to deploy until you open it and tick Use a plain Docker volume (not recommended) under Advanced; see When your servers show Docker only.

A Fleet Token starts with pflt_. Give it to the install script and the server asks to join instead of joining. Use the version from the install line Add servers or ployz server token create shows:

curl -fsSL https://ployz.sh | sudo sh -s -- VERSION --enroll

The script prints Installs Docker and Ployz. and asks for the token at a Fleet Token (from Servers in Ployz Cloud): prompt that doesn't show what you paste. The token never appears on a command line, so it stays out of sudo's log, shell history and ps. The script checks that the token looks like one before it changes anything. It installs the CLI and runs ployz server checkin --install, which checks in with the token and only once Cloud has answered writes it to /etc/ployz/fleet-token, readable by root only. That ends with Waiting for approval, within seconds: Docker installs and ZFS builds in the background while the server waits, and the server shows on the Servers page at once. Two first installs end without it and still exit cleanly, with the service set up and checking in:

  • Cloud can't be reached. Connection errors, timeouts and server errors print the reason and The check-in service keeps trying. The install writes the token without Cloud having answered it, and the server checks in every minute until Cloud does.
  • Cloud holds the check-in back. Cloud's own message follows Cloud held this check-in back:, for example This Fleet Token already has 5 waiting servers. The server isn't on the Servers page yet. It asks again when Cloud says to.

When Cloud already has an enrollment ready for the server, as Enroll on arrival can on a rerun, the install ends with Cloud is ready to enroll this server. The check-in loop runs it. instead. On a server that already joined with that token, it ends Already joined. On a server that can't join yet, it ends with a Blocked. line for each reason ployz status lists, such as Blocked. Already in another cluster. Remove it there first: ployz server rm web-1. When the install starts Docker's install again, an earlier failed Docker install is not one of them.

  • Without ZFS. Put PLOYZ_SKIP_ZFS=1 after sudo, as curl -fsSL https://ployz.sh | sudo PLOYZ_SKIP_ZFS=1 sh -s -- VERSION --enroll. It does what --storage none does for ployz server add.

  • From user data. cloud-init runs user data as root with no terminal to prompt at, so pass the token in PLOYZ_FLEET_TOKEN instead:

    #cloud-config
    runcmd:
      - curl -fsSL https://ployz.sh | PLOYZ_FLEET_TOKEN=pflt_… sh -s -- VERSION

    Any process on the server, containers included, can read user data from the provider's metadata service for as long as the server runs. Give a token you put there a short expiry.

  • Run it again. The same line on the same server updates its token and keeps it one server. The server keeps /etc/ployz/fleet-token until Cloud takes the new token, even when that file doesn't hold a token. If Cloud can't be reached, is busy, or the probe fails, a rerun with a different token ends with Until Cloud takes the new Fleet Token, this install keeps /etc/ployz/fleet-token and changes nothing else. Run the install again. and an error. If the new token already has as many waiting servers as it allows, the rerun ends with Cloud didn't take the new Fleet Token, so this install keeps /etc/ployz/fleet-token and changes nothing else. and an error. Two installs at once take turns writing the file, so a token Cloud didn't take never replaces one it took. A rerun with the same token keeps trying, as a first install does.

  • A token file it can't read. If /etc/ployz/fleet-token exists but can't be read, the install ends with Could not read /etc/ployz/fleet-token and an error before it writes anything. Fix or remove that file and run the install again.

  • An expired token prints Token expired., Cloud's reason, and Run the install again with a new token., and the script exits with an error. A revoked one says so the same way.

  • A token Cloud doesn't know, or a missing PLOYZ_CLOUD_URL when you run your own Cloud, ends the install with Cloud at … refused this Fleet Token. and an error. It says to check PLOYZ_CLOUD_URL only when you set it.

  • Something other than Ployz Cloud answers, such as a 404 or a web page from a wrong PLOYZ_CLOUD_URL, a proxy or a firewall, the install ends with an error that names the URL it reached and says it isn't how Ployz Cloud answers. A proxy or firewall in between may have answered instead. It says to check PLOYZ_CLOUD_URL only when you set it.

When the install ends with an error because the token isn't shaped like one, Cloud refused it, the clock is off, Cloud didn't answer or take a new token on a rerun, the token file couldn't be read, or something other than Cloud answered, it has installed only the ployz CLI and started nothing. On a first install no check-in service is set up and preparation never starts. On a server that already checks in, the running service keeps its old token and goes on as before.

An error after Cloud has answered the token, such as systemd failing to start the service, leaves a partial install. The new token is already in /etc/ployz/fleet-token, and the service files and preparation may be set up. Fix the cause and run the install again.

Without --enroll, the script checks in only when PLOYZ_FLEET_TOKEN is set, and ends with A Fleet Token is pflt_ and 43 more letters, digits, - or _ when it holds anything else, followed by how long the value was, or, at the right length, that it has other characters. It never prints the value. It leaves PLOYZ_ENROLL_TOKEN to ployz server add, and refuses a Fleet Token in it, which older install lines put there; use PLOYZ_FLEET_TOKEN instead. If the server waits longer than you expect, see A server waits for approval.

Ployz opens the ports it needs on the server itself. If your provider runs a firewall in front of it, like a Hetzner Cloud Firewall, a DigitalOcean Cloud Firewall or an AWS security group, allow these there:

PortFromNeeded for
TCP 80, TCP and UDP 443AnywhereYour apps over https, and their certificates, on servers that take web traffic. Not needed behind a Cloudflare Tunnel
UDP 51820Your other serversServices on different servers reaching each other

On a server that runs firewalld (systemctl is-active firewalld says active), also open UDP 51820 and trust ployz-wg in firewalld, as A server that runs firewalld doesn't answer your other servers shows.

Ployz downloads its releases from github.com, which has no IPv6 address. When a server can't reach github.com, the download goes through ployz.sh instead, which has one. So on a server whose only route out is IPv6, the install line still installs ployz, and setup and upgrades still download the Ployz daemon. Setting the server up needs more: it pulls some images from ghcr.io, which has no IPv6 address either, so enrolling the server or running ployz server add can't finish. Do one of these first:

  • Give the server an IPv4 address. Most providers sell one as an add-on, such as a Hetzner Primary IPv4. The server is then dual-stack and installs like any other.
  • Use NAT64 and DNS64. DNS64 answers an IPv6 address for names that only have IPv4 ones, and NAT64 carries that traffic to IPv4. You need both, and they must agree on the prefix: a DNS64 resolver alone, such as a public one, gives addresses nothing answers unless a NAT64 gateway serves its prefix. Use your provider's NAT64 and DNS64, or a public service that runs both. With both in place, the install line works and a single server sets up and runs. The server advertises only its own IPv6 addresses, never the gateway's IPv4 one, and your services resolve names through Ployz as on any other server. A container you start yourself with docker run on Docker's default network has only IPv4, so it reaches neither its resolvers nor anything else. Run it with --network host, or on a Docker network with IPv6 turned on.

With NAT64 and DNS64, your services reach the internet over IPv6. A container's IPv6 address is private, so it lists a name's IPv4 addresses first, and the server can't reach those. Your app's client must try each address, as curl and Python do. One that tries only the first, such as BusyBox wget, fails. A service that publishes a port on the server has only IPv4, so it can't reach the internet at all. Give it a domain instead.

Keep the IPv4 address or NAT64 for as long as the server runs Ployz, because upgrades can pull new images from ghcr.io.

  • Operating system updates stay with you. Ployz doesn't install them.
  • Already running Docker? Ployz keeps it and its settings, if it's Docker 29.2 or newer with buildx 0.18 or newer and the containerd image store turned on. Otherwise setup stops before changing anything; see The install stops while checking Docker. Docker's default never rotates container logs, so they can fill the disk; see The server's disk is filling up.
  • Which Caddy runs? The one the server's Ployz release ships with. Upgrading Ployz on the server moves its web server to the new release's Caddy.
  • A server that never joined doesn't hold up the next one. If a token was used but its server never joined, ployz server ls lists it as down with no version and warns that it hasn't joined and may still be joining. ployz status shows the same. Both name ployz server forget <its ID> --confirm dead. A join keeps going on the server after ployz server add stops waiting, so run it only once that server is deleted or won't join, from wherever you're signed in to the Organization. A Cloud add that fails before the server takes the join, for example over a policy that differs from the server's, prints that command after undo:. The next ployz server add doesn't wait on it: it warns Server web-3 may still be joining and points you to ployz server ls. A server whose add is still running looks the same, so check first: if it's still down with no version after a few minutes, take it out with the ployz server forget <its ID> --confirm dead the warning names. With --json, the result lists each such server under unarrived, with its id, name and that command as next; run it only on the same condition. You get the warning, the command and the list even when the add then fails for another reason, such as a down server.
  • Cloud refuses an enrollment with HTTP 409. When Cloud marks its user-facing reply with a conflict code, the CLI shows its reason and next step, such as contacting support to move a Cluster connected to another Organization. It does not add advice to repeat the same command. For these coded conflicts, --json reports conflict. Generic conflicts and replies from older Cloud versions keep their existing messages, retry advice, and JSON codes.
  • A failed add can be retried with other options. If ployz server add fails after Cloud took the server, for example while downloading or installing the daemon, run it again on the same host, with the same token while it lasts or a new one. It may change options such as --storage. The retry finishes the same server and keeps its address, even after ployz server forget while the server is still joining. If it had finished joining before it was forgotten, the retry is refused and says how to add it with --reset and a new token. Once the server has joined, a retry must match it; to add the host again with other options, run ployz-uninstall on it, remove the old server, and add it again.
  • Client IPs stay out of Ployz's web server logs, not your app's. Caddy passes the client IP to your app in X-Forwarded-For, over IPv4 and IPv6. If your app logs requests, its logs, and the Log Store's copy of them, can hold client IPs and user agents. Those logs are yours to manage.

Next: manage your servers.