Goplesk

Docs

Getting started

This guide takes a fresh Linux VPS to a running Goplesk panel with a license, in about five minutes. You need root, ports 80, 443 and 8443 open, and (for HTTPS) a domain pointing at the server.

1. Install

curl -fsSL https://goplesk.example/install.sh | sudo sh
sudo goplesk install --role=standalone

The installer creates the directories and systemd service, then prints the admin password and cluster key once. Save them. Open https://<server-ip>:8443 and sign in as admin.

For a cluster, install the control plane with --role=dns,control-plane and each worker with --role=worker --token=<cluster key>.

2. Start the free trial

sudo goplesk license trial you@agency.com

You get 14 days of every feature on up to 3 nodes. This also creates your customer account. To log in to the portal later, use set a password with the same email.

3. Activate a paid license

Buy a plan on the pricing page. Your activation code (GPLK-XXXX-XXXX-XXXX) is in the customer portal.

sudo goplesk license activate GPLK-XXXX-XXXX-XXXX

The server checks in once a day to renew its license. Each license file is valid for 14 days, so a short outage of our license server changes nothing for you.

4. Offline / air-gapped servers

sudo goplesk license info     # prints install_id and fingerprint

Paste both into Download offline license in the portal, copy the file to the server, then run:

sudo goplesk license install ./goplesk.license

Offline licenses are valid until the end of your paid period and never contact us.

5. Moving a license to another server

Run sudo goplesk license deactivate on the old server, then activate on the new one. If the old server is gone, use Transfer in the portal. It frees the license and issues a new activation code.

What happens if a license lapses?

Your sites and apps keep serving. Heartbeats, healing and certificate renewals keep running. Only changes in the dashboard and API are paused (read-only) until a valid license is installed again.

Your first deploy

goplesk-cli push --server=<cp>:8443 --ca=./goplesk-ca.pem --app=api --file=./bin/api

The new release starts beside the old one on $PORT, must pass its health check, and only then receives traffic.