Home / API Docs / Guides / FOSSBilling

Servury inside
your FOSSBilling.

Drop our module into FOSSBilling, the free open-source billing panel, and sell Servury VPS under your brand: provisioning, automatic renewals, client power controls, reinstalls and one-click consoles.

Prerequisites01

  • A working FOSSBilling installation. Starting fresh? It's free and takes minutes; see the FOSSBilling install docs.
  • A Servury account. Nothing else.

Activate Servury reseller access02

  • Log in to your Servury account and open the Reseller Dashboard.
  • Click Become a Reseller: instant, free, 5% base discount that grows with volume.
  • Copy your API key and fund your account (balance or saved card).

Install the module03

cd /path/to/fossbilling/modules
curl -Lo servury.zip https://servury.com/downloads/servury-fossbilling.zip
unzip servury.zip && rm servury.zip

Then in the admin panel: Extensions > Overview, activate Servury VPS.

Build your catalog (one command)04

With the module active, build the whole shop from the live Servury plan list. Run from your FOSSBilling root:

SERVURY_API_KEY=yourkey SERVURY_MARKUP_PERCENT=25 \
    php modules/Servicevps/import-catalog.php
  • A product category per location and a product per plan with real specs, wired to the Servury module.
  • Monthly and yearly pricing at your reseller cost plus the markup you choose (default 20).
  • Out-of-stock plans imported hidden; re-run any time to refresh prices and stock. Your own products are never touched.

Prefer clicking? Create a product with the Servury type, open its Configuration tab, enter the Servury URL https://servury.com and your API key, save, then reopen to pick a plan from the live dropdown. Either way, periods map to server time automatically (monthly = 31 days to avoid the sub-31-day surcharge, quarterly = 93, annually = 365), and the order form asks customers for a hostname and OS.

Go live05

  • Connect your customer payment gateway in FOSSBilling as usual and place a test order.
  • On activation the server provisions; the customer's service page shows live status, IP, password reveal, start/stop/restart, password reset, network fix, OS reinstall and an Open console button.
  • Check your Servury reseller dashboard for the wholesale charge.

Show specs in the product list (optional)06

Out of the box, FOSSBilling's product-selection step lists only plan names; the full specs (which the importer stores in each product's description) appear once the customer opens a plan. If you'd rather show the specs inline in that first list too, it's a one-line edit to the order-button template. This is a theme/core template, not part of the module, so re-apply it after major FOSSBilling upgrades.

In modules/Orderbutton/templates/client/mod_orderbutton_choose_product.html.twig, replace the product link with this, which shows the specs inline and the monthly price on the right:

{% set cc = guest.cart_get_currency %}
<a class="list-group-item d-flex justify-content-between align-items-center" href="{{ 'order'|url(query: { 'product': product.id }) }}">
    <span>
        <strong>{{ product.title }}</strong>
        {% if product.description %}<div class="text-secondary small mt-1">{{ product.description|split(' · ')|slice(0, 4)|join(' · ') }}</div>{% endif %}
    </span>
    <span class="text-nowrap ms-3">
        {% if product.price_starting_from is not null %}<strong>{{ (product.price_starting_from * cc.conversion_rate)|format_currency(cc.code) }}</strong><span class="text-secondary small">/mo</span>{% endif %}
        <svg class="icon ms-2"><use href="#arrow-right" /></svg>
    </span>
</a>

Clear the template cache afterward (rm -rf data/cache/*). Each plan then shows its CPU / RAM / storage / network inline under the name and the monthly price on the right. The full labelled spec list still appears on the configuration step, untouched.

How it operates day to day07

  • Renewals: FOSSBilling calls the module natively on every order renewal; the upstream server extends by the billing period automatically.
  • Non-payment: suspension powers the server off, unsuspension powers it on; deleting the order terminates the server permanently.
  • Billing note: keep your Servury balance funded (or a card saved); every create and renewal charges it at your reseller discount.

Free panel,
our servers.

Instant reseller activation, 5% base discount, plans loaded straight from the API.

Start Reselling