Account types

The three account levels (administrator, reseller, user), reseller pools and plans, creating, suspending and deleting accounts, and signing in as one.

Every account has a level: Administrator, Reseller or User. The level decides what the account sees. There is no public sign-up: administrators create accounts of any level, and resellers create users for themselves.

The three levels#

Level Sees and manages Creates servers
Administrator Everything: nodes, locations, images, every plan, account and server, tasks, logs and panel settings. What an administrator may do can be narrowed by a staff role. On any node, for any account, from a plan or with a custom size
Reseller Its own servers, its users and their servers, its own plans For itself and its users, from its own plans, in the locations an administrator granted it
User Its own servers For itself, from a plan, only when the account has May create and delete servers

Resellers and users never see a node, a task page or what a node reported: the server page says what happened in plain words. A server or account outside their own answers "not found", so its existence is not revealed.

A user belongs either to a reseller (its parent) or to nobody. A user without a reseller is a direct customer of the panel and is offered the panel's plans.

Creating an account#

  1. Go to Customers › Users › Create account.
  2. Fill in Name, Email address and Level.
  3. For a User: choose its Reseller (or none) and tick May create and delete servers if the customer should create its own servers. Without it the user only uses the servers created for it.
  4. For a Reseller: tick the Locations it may use (with none ticked it cannot create servers) and set its Limits (see below).
  5. For an Administrator: choose a Role (see Staff roles).
  6. Choose the First password:
Option What happens
Email a link to set it Offered while mail is set up (the default then). The account gets a one-time link valid 72 hours and is listed as Invited until it uses it. Send the link again is on its page.
Generate The panel makes a 20-character password and shows it once.
Set my own You type it: at least 12 characters with upper and lower case letters, a digit and a symbol. It is shown once more after saving.
  1. Press Create account.

A password is never mailed and never stored where it can be read. Language on the same form sets the account's language (see Languages).

The first administrator is created on the command line by the installer. To create another full administrator from the shell:

cd /opt/vmstack/current
runuser -u vmstack -- php artisan vmstack:create-admin [email protected] --link

--link sets no password and prints a one-time link (72 hours) that sets it. If the link is lost, vmstack-panel admin-link [email protected] prints a new one while the administrator has not set a password yet.

Reseller pools and plans#

Limits belong to resellers. A reseller's limits form one pool that covers the reseller and all its users. A user has no limits of its own.

The pool can limit any of these (leave a field empty for no limit):

Limit Counts
Servers every server of the family that still exists, whatever its status
vCPUs, Memory (GB), Disk (GB) the sizes of those servers; disk includes extra disks
Addresses public IPv4 addresses assigned
Traffic a month traffic the family's servers used this calendar month (UTC), entered in GB or TB (1 TB = 1024 GB)
Users how many user accounts the reseller may have
Kept backups, Snapshots backups and snapshots that hold space (shown once those features are installed)
  • A limit below what is in use only stops new servers and upgrades; nothing is removed.
  • When a user's server is refused because the pool is full, the user reads "Your provider's limit has been reached. Contact your provider." The reseller and administrators read which limit and by how much.
  • A pool that has used all its traffic takes no new server until the 1st of the month.

A reseller makes its own plans under Customers › Hosting plans › Add plan. No figure of a reseller plan may exceed the reseller's limit for it, and with a traffic limit every plan must state its traffic. The reseller and its users choose from the reseller's plans only; an administrator creating a server for them picks from those plans too, or sets a custom size. A plan that has become larger than the pool is marked Too large and cannot be used until the plan or the limit changes. Plans themselves are described in Plans.

Each account's figures are on Usage & limits (in the sidebar for resellers and users; for staff, the link on the account's page). Customers can set their own usage alerts there, as an amount or a percentage of a limit; they are checked every five minutes and fire once per crossing, as a notice in the panel and an optional mail. Staff see a customer's alerts read-only.

Setting up a first reseller#

  1. Customers › Users › Create account: level Reseller, tick its locations, set its pool. Copy the password shown.
  2. Sign in as the reseller (see below) and add a plan under Customers › Hosting plans › Add plan.
  3. Customers › Users › Create account creates a user of that reseller.
  4. Servers › Create server: owner (the reseller or one of its users), location, plan, image.

Suspending, deleting and changing level#

All of these are on the account's page (Customers › Users, then the account).

  • Suspend account stops the account signing in and ends its open sessions at their next request. Its servers keep running.
    • Suspending a reseller does not suspend its users: they still sign in and manage their servers, but no new servers are created for them until the reseller is unsuspended.
    • A reseller lifts only suspensions it placed itself. One placed by an administrator is lifted only by an administrator; the reseller reads "An administrator suspended this account. Only an administrator can lift it."
    • You cannot suspend yourself or the last active administrator.
  • Set a new password types or generates a new password (shown once) and signs the account out everywhere.
  • Delete account works only for an account that owns no servers and, for a reseller, has no users and no plans. Otherwise the page says what is in the way.
  • Level can be changed by administrators only. A reseller cannot become a user while it has users or plans. Nobody changes their own level, and the last administrator stays one.
  • A server's owner is changed from the server's Manage tab (Change owner); the new owner's pool is checked.

Accounts are not deleted by their owners: there is no "delete my account" form.

Signing in as another account#

An administrator can sign in as any reseller or user; a reseller as one of its own users. Nobody can sign in as an administrator.

  1. Open the account (or find it in the users list) and press Sign in as.
  2. A bar at the top of every page says You are signed in as the account, with Return to my account.

While signed in as an account you see and can do exactly what it can. Its password, email address, two-factor settings and passkeys cannot be viewed or changed ("Return to your own account to change settings."). Your own suspension, two-factor requirement and allowed addresses apply, not the account's. Every start and end is in the audit log, and every entry made meanwhile names both, for example "Ada Admin (as Olivia Owner)". A root password you reveal is attributed to you as well.

The session returns to you by itself when the account is deleted or you may no longer enter it. Signing in as an account is not possible from inside a team account.

Mailing your users#

Customers › Mail users sends a message to a chosen audience (levels, nodes, locations, hosting plans, reseller families), now or at a set time. A Service notice goes to everyone in the audience; News skips whoever unsubscribed and carries an unsubscribe link. Resellers can use it for their own users only when Resellers may mail their users is on under System › Settings › Mail, and may send one message an hour. Customers › Announcements shows banners on the dashboard and servers list instead of, or as well as, a mail.