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#
- Open the Sign in link from the installer's summary (
https://panel.example.com/invite/…). It works once and for 72 hours. - On Set your password, type the password twice and click Set password.
- 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.
- Go to System › Settings › Mail.
- Choose the Mailer and fill in its fields (for SMTP: Host, Port, Encryption, User name and password), then From name and From address.
- Click Save settings.
- 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.
- Go to Infrastructure › Locations.
- Click Add location, enter a Name and choose the Country, and save.
5. Add your first node#
- Prepare a Debian 13 server that meets the node requirements.
- Go to Infrastructure › Nodes › Add node, enter its name, location and address.
- 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.