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.
openssl s_client -connect <host>:2222 </dev/null 2>/dev/null | \
openssl x509 -noout -fingerprint -sha256Encrypted 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.
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.
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.
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.