First-time setup

From the installer's sign-in link to a working panel: set the password, licence the panel, set up mail, add a location and your first node.

When the installer finishes, it prints a one-time sign-in link. This page takes you from that link to a panel that can create servers. Do the steps in this order: each one is needed by the next.

1. Set the administrator's password#

  1. Open the Sign in link from the installer's summary (https://panel.example.com/invite/…). It works once and for 72 hours.
  2. On Set your password, type the password twice and click Set password.
  3. Sign in with the administrator's e-mail and that password.

Lost the link, or it expired? On the panel server, as root:

vmstack-panel admin-link [email protected]

It prints a new link, and the previous one stops working. It works only while the administrator has not set a password; after that, use Forgot password on the sign-in page (once mail is set up) or ask another administrator.

Turn on two-factor sign-in for your own account now; see Sign-in security.

2. Licence the panel#

The panel needs a licence before it can create servers and add nodes. While the panel has no licence and no node, signing in takes an administrator to Welcome to VMStack, with two choices:

  • Start a 30-day trial: every feature, any number of nodes, no card. See Free trial.
  • I have a licence key: paste the key from your vmstack.eu account and click Activate. See Activate a licence.

Later goes to the dashboard for this session. The same screen is always at System › Settings › Licence. If you passed --licence-key to the installer and the summary said it was activated, the panel is licensed already.

3. Set up mail#

Mail is off on a new panel: no password resets, alerts or customer notices are sent, and the dashboard shows Mail not set up.

  1. Go to System › Settings › Mail.
  2. Choose the Mailer and fill in its fields (for SMTP: Host, Port, Encryption, User name and password), then From name and From address.
  3. Click Save settings.
  4. Under Test, enter an address in Send to and click Send test mail. The page shows what the mail server answered.

Once a from address is saved, the page also says which DNS records its domain needs.

4. Add a location#

Every node belongs to a location: a datacentre or region your customers choose from.

  1. Go to Infrastructure › Locations.
  2. Click Add location, enter a Name and choose the Country, and save.

5. Add your first node#

  1. Prepare a Debian 13 server that meets the node requirements.
  2. Go to Infrastructure › Nodes › Add node, enter its name, location and address.
  3. Run the install command the panel shows on the node, as root.

The node enrols by itself within a minute. The full procedure is in Add a node.

6. Before the first server#

  • Addresses: add the node's IP blocks under Infrastructure › IP pools; see IP pools.
  • Images: the installer adds the standard operating system images to Images and ISOs › Images; enable or add the ones you offer. See Images.
  • Plans: create the sizes you sell under Customers › Hosting plans; see Plans.

7. Protect the panel#

  • Set up Panel backup to a destination off the server, and download its key.
  • Decide how the panel updates itself under System › Settings › Updates; automatic updates are off by default. See Panel updates.
  • Check System › Health: every queue should have a worker and the scheduler should be running. The dashboard shows a Needs attention · Panel health card when something stops.