Install the controller

About 5 min

The controller is gocdn's management plane. One is enough. This page covers the requirements, what the installer does, and a post-install check.

Demo
Step 1 / 5
Download

The script is saved to a temporary file first and runs only if the download succeeded

t=$(mktemp) && curl -fsSL https://<provider>/i/•••• -o "$t" && bash "$t"
Step 2 / 5
Dependencies

MariaDB, ClickHouse and so on

Step 3 / 5
Controller

The controller program and its systemd units; creates the first administrator

Step 4 / 5
Register and check

Registers with the license service and runs a local health check

Step 5 / 5
Done

The panel address is printed; the initial password is in /root/gocdn-admin.pass

MASTER_INSTALL_DONE <version>
SystemDebian 13 / Ubuntu 26.04 or later
Memory4 GB or more
/var/lib free≥ 20 GB
One command installs the controller; it can be re-run and skips what is done

Requirements

  • Debian 13 / Ubuntu 26.04 or later, x86_64 or arm64, with systemd.
  • At least 4 GB RAM and 20 GB free under /var/lib.
  • Internet access; do not put it on the same machine as a node.
  • Run as root.

Install

After your trial starts or you purchase, the install command is emailed to you. Log in to the server and run the whole line:

t=$(mktemp) && curl -fsSL https://<provider>/i/•••••••• -o "$t" && bash "$t"

Use the command from your email

The command downloads the script to a temporary file and runs it only if the download succeeded, so a network failure makes the whole command fail instead of looking like a successful install.

When the command does not name a version, it installs the default version for new installs (latest) from the materials site. That version is used only after it passes the superadmin signature check; on a bad signature (for example, latest pointed at an old release) the script exits without installing anything or changing the local version.

Tip The command carries a one-time token, valid for 72 hours and usable once. If it has expired, ask your provider for a new one.

What the installer does

It installs dependencies (MariaDB, ClickHouse and so on), the controller program and its systemd units, creates the first administrator, starts the services, registers with the license service and runs a local health check. It can be re-run: finished steps are skipped and missing ones are filled in; the password, keys and administrator are never recreated.

After it finishes

The panel address is printed and the last line is MASTER_INSTALL_DONE <version>. The first administrator is admin, and the initial password is in /root/gocdn-admin.pass. Change the password after logging in, then delete the file.

Caution The controller address inside node install commands must be reachable from the nodes. If the controller is behind cloud NAT, or you opened the panel with a private address, first set the node communication address under System Admin › Upgrade & Maintenance › Node Communication, then get the node command; see Add nodes.

Check

  • The panel opens in a browser and you can log in.
  • System Admin › Upgrade & Maintenance › Master Upgrade shows the current version.
  • The license status in System Settings is normal; see Licenses and add-ons.

Next: Add nodes.

Get started

Try the live demo

Open the live demo, or contact us for a quote and the install command