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