Docs

Install

One command on a Linux host. Docker Swarm, Traefik, Postgres, and the panel.

Quick install

curl -fsSL https://raw.githubusercontent.com/bablilayoub/nixploy/main/install.sh | sudo bash

With a domain (Let's Encrypt)

NIXPLOY_DOMAIN=panel.example.com NIXPLOY_LETSENCRYPT_EMAIL=you@example.com \
  curl -fsSL https://raw.githubusercontent.com/bablilayoub/nixploy/main/install.sh | sudo bash

What the installer does

  1. Installs Docker if needed and initializes Swarm
  2. Writes secrets under /etc/nixploy
  3. Pulls (or builds) the Nixploy image from GHCR
  4. Starts Postgres + Traefik + the panel
  5. Prints the setup URL for the first owner account

Useful overrides

  • NIXPLOY_VERSION / NIXPLOY_IMAGE — pin or override the app image
  • NIXPLOY_PORT — host port (default 3000)
  • NIXPLOY_CONFIG_DIR — config root (default /etc/nixploy)
  • NIXPLOY_GITHUB_TOKEN — private-repo install/update
  • NIXPLOY_SKIP_DOCKER_INSTALL=1 — use an existing Docker daemon

Update

curl -fsSL https://raw.githubusercontent.com/bablilayoub/nixploy/main/update.sh | sudo bash

Updates keep .env, Postgres data, and Traefik ACME certs. Migrations run on boot.

Also see the repository guides under docs/ · REST API reference

Docs menu