How to create a hosting account (new customer)

For server administrators · Updated 2026-10-29

On this page
  1. Before you start
  2. Steps
  3. What happens next
  4. Rules each field must follow
  5. Common questions

A hosting account is one customer: a system user with its own home folder, a main website, a DNS zone, email and databases. Every account gets its limits from a package.

Before you start

  • You need the admin panel (https://<server>:2087). Resellers need the Create accounts privilege.
  • You need at least one package. If there is none, the page shows You need a package first. with a link to create a package.

Steps

  1. Open Create Account in the menu (section Accounts). The page Create a New Account opens.
  2. Domain — the main domain of the account, for example example.com. Leave out www. and https://; they are removed if you type them.
  3. Username — 2–16 characters, lowercase letters and digits only, starting with a letter, for example shop1.
  4. Password — type one or click Generate.
  5. Contact email — where the customer receives notices (disk full, bandwidth used, ticket answers).
  6. Choose a package — the list shows each package with its disk space.
  7. Click Create.

You see Account created successfully. and the account's page opens.

What happens next

  • The server creates the system user, the home folder /home/<username>, the website (its files go in public_html), the DNS zone and the email signing key. This runs as tasks in Task Queue and takes a few seconds.
  • A free SSL certificate is requested automatically. It is issued once the domain points to the server.
  • Everything in /etc/sahaab/skel on the server is copied into each new home folder. See Files for new accounts in Server Settings.
  • The account uses the server's shared IP address.

Rules each field must follow

  • Password: at least 8 characters (at most 128) with at least 3 of: lowercase letters, uppercase letters, digits, symbols.
  • Username: must not be taken by another account or reseller. Names the system uses itself (for example root, admin, mail, www, test) are reserved.
  • Domain: must not already be hosted on the server, and must not be the server's own hostname or nameservers.

Common questions

Why do I get "The domain example.com is already hosted on this server."?

Another account already has that domain as a main domain, addon domain, subdomain or alias, or a DNS zone with that name exists. Remove it there first, or move the addon domain.

Can I change the package, domain or username later?

Yes. Open List Accounts, click Manage and use Modify account. See change the package, change the main domain and change the username.

Can I create accounts automatically from my billing system?

Yes, with an API token. See create an account with the API or connect WHMCS.

Was this article helpful?

Still stuck?

Ask the AI about your exact situation — it answers from this knowledge base — or contact us.