BILLmanager Installation guide

From ISPWiki
Jump to: navigation, search

System requirements

Supported operating systems for BILLmanager

  • CentOS 7 Х64

We strongly recommend a clean install of BILLmanager. You should install a minimal version of the operating system, all the services that BILLmanager requires will be installed automatically during software installation.

License policy

You may obtain a free version of BILLmanager that you can use for an unlimited period of time. This free version comes with the following resource limitation: in BILLmanager you can create and manage only 50 client accounts. The license will be activated automatically during installation.

If you have a "commercial license", it will be activated automatically, given that your server's public IP address matches the license IP. If your server is assigned a private IP address, execute the following command:

export ACTIVATION_KEY=<activation_key>

If you have a lifetime license, please pay attention to its updates expiration date. If updates for your lifetime license have already expired during setup, trying to install the latest version of the corresponding control panel will cause issues with license activation. In this case, you need to start the installation process with the --release 5.50 parameter, where 5.50 is the latest version available for a lifetime license.


BILLmanager is installed and updated from the OS repository.

Establish SSH connection as the root user and download the script to start the installation


and execute

 sh BILLmanager

In order to install a certain version of a control panel, run with the --release parameter. E.g.:

sh BILLmanager --release 5.50

Choose a required version - beta or stable. The installation script will connect required repositories (EPEL for CentOS), and update the package cache.

Select a BILLmanager version. The script will install BILLmanager and packages it requires.

Example on CentOs 7.1

BILLmanager installation

Once completed, you can login to BILLmanager using the following access details:

Url: https://<server IP address>:1500/billmgr

Login: root

Password: <root password>

Attention!!! If port 443 is already in use, the billing panel can be accessed at Url: https://<server ip address>:1500/billmgr


In the System configuration module you can select the corresponding option if you want the control panel to automatically update.

In order to update the panel manually, use standard methods of your operating system.

Please note: every control panel's version is bound to a separate repository, which name matches its version. The beta5 and stable5 repositories contain all the versions of a software product. The product's version to which you can update depends on the connected repository.


 yum update

Preliminary setup

For more information please refer to the article BILLmanager preliminary setup.

Upgrading to higher versions

If you want to upgrade, for example, from BILLmanager to BILLmanager Corporate, execute the script /usr/local/mgr5/sbin/

Specify a name of a required version:

/usr/local/mgr5/sbin/ corporate

The downgrade is not supported.