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.
What you need
Section titled “What you need”- 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.
Add one server that joins right away
Section titled “Add one server that joins right away”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.
Approve a join
Section titled “Approve a join”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.
Add a standalone server
Section titled “Add a standalone server”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
Your first server's first key
Section titled “Your first server's first key”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 loginandsudo 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 requeston your computer, then on the server runsudo ployz loginandsudo 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.
Add servers from the dashboard
Section titled “Add servers from the dashboard”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.
Choose a name and Cloudflare Tunnel first
Section titled “Choose a name and Cloudflare Tunnel first”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.comis 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:
- Go to Servers and click Add servers. While you have no server, the bottom bar of your environment offers it too.
- Name the token, or leave the name blank and Ployz picks one. Choose how long it works: 1 day, 7 days or 30 days.
- 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.
- 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.

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.
Your tokens
Section titled “Your tokens”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.
Add many servers with a Fleet Token
Section titled “Add many servers with a Fleet Token”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.
--expirestakes1d,7dor30d. - 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.
Use an empty spare disk for volumes
Section titled “Use an empty spare disk for volumes”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.
Start without ZFS
Section titled “Start without ZFS”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.
Install with a Fleet Token
Section titled “Install with a Fleet Token”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 exampleThis 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=1aftersudo, ascurl -fsSL https://ployz.sh | sudo PLOYZ_SKIP_ZFS=1 sh -s -- VERSION --enroll. It does what--storage nonedoes forployz 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_TOKENinstead:#cloud-config runcmd: - curl -fsSL https://ployz.sh | PLOYZ_FLEET_TOKEN=pflt_… sh -s -- VERSIONAny 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-tokenuntil 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 withUntil 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 withCloud 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-tokenexists but can't be read, the install ends withCould not read /etc/ployz/fleet-tokenand 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, andRun 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_URLwhen you run your own Cloud, ends the install withCloud at … refused this Fleet Token.and an error. It says to checkPLOYZ_CLOUD_URLonly 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 itisn't how Ployz Cloud answers. A proxy or firewall in between may have answered instead. It says to checkPLOYZ_CLOUD_URLonly 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.
Open the firewall
Section titled “Open the firewall”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:
| Port | From | Needed for |
|---|---|---|
| TCP 80, TCP and UDP 443 | Anywhere | Your apps over https, and their certificates, on servers that take web traffic. Not needed behind a Cloudflare Tunnel |
| UDP 51820 | Your other servers | Services 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.
IPv6-only servers
Section titled “IPv6-only servers”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 runon 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.
Good to know
Section titled “Good to know”- 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 lslists it as down with no version and warns that it hasn't joined and may still be joining.ployz statusshows the same. Both nameployz server forget <its ID> --confirm dead. A join keeps going on the server afterployz server addstops 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 afterundo:. The nextployz server adddoesn't wait on it: it warnsServer web-3 may still be joiningand points you toployz 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 theployz server forget <its ID> --confirm deadthe warning names. With--json, the result lists each such server underunarrived, with itsid,nameand that command asnext; 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,
--jsonreportsconflict. 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 addfails 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 afterployz server forgetwhile 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--resetand a new token. Once the server has joined, a retry must match it; to add the host again with other options, runployz-uninstallon 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.