BlueOnyx Server Module for FOSSBilling

We are pleased to announce the release of the BlueOnyx Server Module for FOSSBilling. The module is now available free of charge in the BlueOnyx Shop as part of our Free Bundle and can be installed on BlueOnyx 5212R, 5211R, and 5210R.

The module source code is also available on GitHub: github.com/MichaelStauber/fossbilling-blueonyx-server-module

What is it?

FOSSBilling is an open-source billing and client management solution for hosting providers. The BlueOnyx Server Module extends FOSSBilling with a BlueOnyx APIv2 server manager, allowing hosting providers to sell BlueOnyx Vsites as products and provision them automatically on one or more BlueOnyx servers.

When a customer places an order in FOSSBilling, the module creates the Vsite, the site administrator user, disk quotas, shell settings, email aliases, PHP configuration, MariaDB databases, and email autoconfig aliases on the assigned BlueOnyx server through the API. If provisioning fails partway through, the partially created Vsite is automatically rolled back.

Key features

• Hosting plan editor: Create BlueOnyx-specific hosting plans with PHP handler and version selection, shell access levels, subdomain limits, MariaDB provisioning, email autoconfiguration, and DNS auto-creation — all from within the FOSSBilling admin area.
• Automatic provisioning: Full Vsite lifecycle support including create, suspend, unsuspend, cancel, delete, change package, and change password — all propagated to the BlueOnyx server through the API.
• Multiple servers: Add as many BlueOnyx servers as needed. Each product can be assigned to a specific server, allowing provisioning across multiple BlueOnyx instances.
• Local and remote API modes: Connect to a BlueOnyx server on the same machine (local mode with password authentication) or over the network (remote mode with client-secret authentication).
• Customer self-service: Customers can view Vsite details, change their password, change their domain, check SSL status, and request Let's Encrypt certificates — all from the FOSSBilling client area.
• Asynchronous Let's Encrypt: Certificate requests are queued and processed during the FOSSBilling admin cron run, preventing browser timeouts.
• No core file modifications: The module deploys its own template overrides into html_custom on installation and removes them on uninstallation. No FOSSBilling core files are touched.

Availability

The BlueOnyx Server Module for FOSSBilling is available as a PKG package for BlueOnyx 5212R, 5211R, and 5210R in the BlueOnyx Shop as part of the Free Bundle — at no cost.

Documentation

A detailed FAQ article with step-by-step setup instructions and screenshots covering API configuration, module installation, server setup, hosting plan creation, product configuration, the customer ordering experience, and service management is available here:

BlueOnyx Server Module for FOSSBilling — FAQ Article