Skip to content

Documentation

DirectAdmin

DirectAdmin is the control panel integration. It creates and manages web hosting accounts on a server that is already running. There is no operating system to install and no machine to boot. An account is created, given a package, and later suspended, moved to another package or removed.

What you need

Do not use the administrator password. DirectAdmin has login keys, and a login key is the right shape for this: you can limit it to a list of commands, to a list of addresses, to an expiry date and to a number of uses.

  • Host: the panel's address. Port 2222 is filled in for you if you leave it out.
  • Username: the account the login key belongs to.
  • Login key: created under your own account, not a password.
  • TLS fingerprint: optional, and only meaningful on an HTTPS host.
shell
openssl s_client -connect <host>:2222 </dev/null 2>/dev/null | \
  openssl x509 -noout -fingerprint -sha256
Commands and terminal output are in English everywhere, in the panel and in these pages. One text, one truth: what you read here is literally what your host will print back.
Give the key the commands the integration needs and no more. If the panel tells us which commands the key may run, the agent refuses a call the key is not allowed to make before it is sent, and names the command. Not knowing is not the same as not allowed: a panel that reports nothing blocks nothing.

Encrypted or not

DirectAdmin listens on port 2222 without TLS by default, and plenty of installations run that way. Provibr accepts it, because refusing would make the integration impossible on an otherwise perfectly normal server. What it does instead is tell you.

On a plain-text connection the integration reports as active with a warning: the login key and everything this integration does travel unencrypted. Your agent is the only party that can know this, because the platform never sees the host after you saved it.

A TLS fingerprint together with a plain-text host is refused rather than ignored. Pinning a certificate on a connection that has none is a promise nobody can keep.

Settings

There are none. A DirectAdmin server decides for itself where an account lives and which address it gets, so there is nothing left for you to choose. The settings tab still exists, because that is also where you resend credentials.

Hosting packages

A DirectAdmin package is the panel's own description of an account: disk quota, monthly traffic, how many domains, which services are on. It is not a Provibr plan and not an operating system. It is a name we refer to, and its contents can change on your server without us noticing.

The integration page can read the list of packages with what is in them, so you can see what you are choosing rather than typing a name from memory.

A web plan pins one package on one integration and gives it a name of your own. Ordering with a plan beats picking a loose package, and the loose picker stays available for the cases a plan does not cover.

What an account looks like in Provibr

A hosting account is an ordinary server row of the type webserver. Its identifier is the DirectAdmin username, and its domain, package, quota and traffic come along on every poll.

  • Creating an account needs a username, one domain, an email address, a package and a password.
  • Usernames follow DirectAdmin's own rule: starting with a letter, then letters and digits, three to sixteen characters. No hyphens.
  • The password is not recorded anywhere. Only the fact that you supplied one is; the value travels separately.
  • Afterwards you can suspend, resume, change the package and delete. There is no console, because a hosting account does not have one.
DirectAdmin does not pick an address for you. If your server has exactly one, that one is used; if it has several, the first is used, which is what the DirectAdmin interface itself proposes. With none at all, the creation is refused rather than half-done.

Adopting accounts that already exist

The import tab lists the accounts on the panel and lets you take the ones you want into Provibr. Accounts already known are shown but cannot be selected again, so you can see the whole picture rather than a filtered one.

Imported accounts count towards your capacity exactly like accounts you ordered. Import more than you have room for and an overage opens, with the usual grace period.

Usage

Quota and traffic ride along with the regular poll, so an account gets a usage graph without anything extra being switched on. Monthly traffic is a property of the account rather than a rate, so it is shown as a number on the account and not as a line on the graph.