Skip to content

Documentation

ISPConfig

Provibr manages ISPConfig hosting accounts through the panel's remote API. The agent dials out to your ISPConfig install, so there are no inbound ports and no VPN. This page covers what is different about ISPConfig and what the integration does.

One account is one website

ISPConfig separates the client (the customer, with a login and a set of limits) from the web_domain (the website). One Provibr hosting account is one website, identified by its domain. To create a website you need an owner, so Provibr creates a fresh client and a website under it, and removes both again when you delete the account. The agent derives the client login from the domain, so it always finds the owner back.

What the agent needs

Four fields, entered once when you connect the integration:

  • The panel address: the full https URL, including the port (8080 by default).
  • A remote user: created under System → Remote Users, scoped to the client and site functions.
  • The password of that remote user.
  • The TLS fingerprint of the panel: recommended, because a fresh install is self-signed.
The remote user is a separate account, not your panel administrator. ISPConfig lets you scope it to exactly the functions Provibr uses, so the credential in the agent vault can be limited to the client and site calls and nothing else.

The certificate

ISPConfig listens on port 8080 over TLS, and a fresh install serves a self-signed certificate. Pin its fingerprint so the agent can be sure it is reaching your panel. Read it with a shell command from any machine that can reach the panel:

shell
openssl s_client -connect <host>:8080 </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.

If you put your own certificate on the panel hostname, for example with Let's Encrypt, its chain verifies and you can leave the fingerprint empty. That is the better choice there, because such a certificate renews regularly and a pinned one would have to be replaced every time.

Packages

An ISPConfig package is a client template, the same thing a Provibr plan refers to. It sets the limits a client gets: how many websites, how much disk and traffic, which services.

You choose a package by name in the order form, and change it later without downtime. Changing it moves the client's limits at once.

The remote API cannot create a client template, so you build the packages in the ISPConfig panel yourself. Provibr only refers to them by name; a name it does not recognise is refused before anything is created.

The account lifecycle

Creating an account is two steps behind one command: a client and a website under it. From then on the account behaves like every other hosting account:

  • Create: a client with the chosen package, and a website with its domain and quota.
  • Suspend and resume: the website goes offline and comes back, reversibly.
  • Repackage: assign a different client template.
  • Remove: the client and its website, cleaned up together.

Suspending

Suspending flips the website's active flag. The site goes offline; the client login stays. Provibr reads the same flag it writes, so the panel and what you see never drift apart.

The database flag flips at once, but the web server configuration is rewritten by the panel's per-minute job. What Provibr shows is the active flag, and that is consistent immediately.

Usage

ISPConfig reports usage: disk per website against its quota, and traffic for the current month. Both appear in the graphs like they do for a virtual machine.

Disk usage is filled once the panel's monitor job has run, so on a fresh website there is no reading yet, and that is not the same as zero. Traffic comes from one call for all sites; disk is one call per client.

Importing

Accounts you created in ISPConfig outside Provibr can be imported: the integration lists the websites the panel knows, and you pick the ones to take over. Accounts you did not create through Provibr are left alone until you do.