Skip to content

Documentation

Plesk

Plesk is the second control panel integration. It creates and manages subscriptions on a server that is already running. There is no operating system to install and no machine to boot. A subscription is created, given a service plan, and later suspended, moved to another plan or removed.

What you need

Do not use the administrator password. Plesk has API keys, and a key is the right shape for this: it is bound to the account that made it, it can be limited to a set of addresses, and you can withdraw it without changing anyone's password.

  • Host: the panel's address. Port 8443 is filled in for you if you leave it out, and the address has to be https.
  • API key: created under Tools & Settings, with an administrator account.
  • TLS fingerprint: optional, and needed whenever the panel still has its self-signed certificate.
shell
openssl s_client -connect <host>:8443 </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.
A key made with a reseller or customer account only sees that account's own subscriptions. The agent notices this at the first probe and refuses the credentials rather than quietly managing half a panel.

One key, two APIs

Plesk has a REST API and an older XML/RPC API, and neither is complete on its own: REST has no subscriptions and no service plans, XML has everything but returns XML. Provibr uses both: creating and removing over REST, reading, suspending and switching plans over XML. The same key opens them, so you fill in one value.

The two APIs fail differently: REST answers an unusable key with an empty HTTP 401, while XML answers HTTP 200 with an error inside it. The connection test therefore probes both and reports them separately. A green REST result with a silent XML API means the account list, the plan list and switching plans will all stay empty.

Encrypted, always

Unlike DirectAdmin there is no plain-text option here: Plesk redirects http on both 8880 and 8443 to https, so Provibr refuses an http address instead of pretending it could work.

What a fresh install does have is a self-signed certificate. Fill in its fingerprint and the agent trusts that one certificate instead of switching verification off; replace the certificate later and the fingerprint has to follow.

Service plans

A Plesk service plan is the panel's own description of a subscription: disk quota, monthly traffic, how many domains and mailboxes, 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 service plans from the panel, so you can see what you are choosing rather than typing a name from memory.

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

What a subscription looks like in Provibr

A subscription is an ordinary server row of the type webserver. Its identifier is the subscription name, which in Plesk is the main domain, and its service plan, quota and traffic come along on every poll.

  • Creating a subscription needs a main domain, an email address, a service plan and a password. There is no separate account name to think up.
  • The domain is the identity: it is what the panel shows, what its API filters on, and what Provibr stores. It cannot be changed afterwards.
  • The password is not recorded anywhere. Only the fact that you supplied one is; the value travels separately and becomes both the customer and the FTP password.
  • Afterwards you can suspend, resume, change the service plan and delete. There is no console, because a hosting account does not have one.
Plesk picks the address itself from its own pool, so there is nothing for you to choose. Provibr does not reserve an address for a subscription either, which is why the address field of a hosting account stays empty until the panel reports one.

Adopting subscriptions that already exist

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

Imported subscriptions count towards your capacity exactly like subscriptions 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 a subscription gets a usage graph without anything extra being switched on. Monthly traffic is a property of the subscription rather than a rate, so it is shown as a number on the account and not as a line on the graph.