All manual sections

DocumentationKoaPanel account

KoaPanel account

The panel can be connected to your KoaPanel account, the customer area at console.koapanel.app/account (sign-in with Prime Software ID). Connecting gives you the Free plan license, and the customer area holds the panel's licenses, orders, invoices and support requests.

Connecting the panel

In Plan and license press Connect to the account. The panel shows:

  • a short code (for example BCDF-GHJK);
  • the Open the connection page button and a QR code with the same link, handy from a phone.

Open the link, sign in or create the free account and confirm the code. The panel notices by itself within a few seconds, activates the Free plan license and shows "Connected to the account a••••@…". The panel never asks for your password: the connection is approved only in the customer area.

  • The code expires after 15 minutes: if it does, get a new one.
  • If you press It's not me in the customer area, the connection is refused.
  • If the console does not respond, the panel retries by itself while the code is valid.
  • Only the panel administrators can connect it.

Each account has one Free plan, and each server one account. To use the Free plan on another server, move it from the customer area ("Move to another server"). Paid licenses are still activated by pasting the code, as before.

New and existing installs

  • Panels installed before 0.20: nothing changes. The Free plan keeps working as before; connecting the account is optional.
  • Panels installed from 0.20 on, without a license: the Free plan needs an account. Until the panel is connected, after signing in only the connect page is shown and the rest of the panel stays idle (from 0.42.0; from 0.41.2 no sites could be created); a notice stays at the top of the pages and the Overview shows the box to connect it. Once connected, the Free plan limits apply (up to 3 sites). No existing site is ever stopped.

A panel counts as "new" if, at the first start of 0.20, it had neither sites nor a license.

Cloud marketplace images

On servers created from the cloud providers' marketplaces (Vultr, DigitalOcean, Akamai/Linode) the Free plan works without an account for 14 days after the install: you can create up to 3 sites right away. The Overview and Plan and license show how many days are left; when they run out the panel asks you to connect the free account as above, and the sites already created keep working.