Docs / Selling hosting with NimboBilling — install and first steps

Selling hosting with NimboBilling — install and first steps

NimboBilling is the store and billing application that comes with every paid Nimbopanel license. It is a separate application, not a part of the panel: the panel takes no payments and serves no sales pages. NimboBilling gives you a store on your own domain, invoices, customer accounts and a help desk, and when an invoice is paid it creates the hosting account on the panel for you. This guide is the install and the first hour. What the app offers is on the NimboBilling page, and the short version of the set-up is in Marketing website.

Only an administrator or a reseller installs it, from their own session, on a hosting account that is theirs.

Before you start

  • A paid license. On the Free tier the catalog lists NimboBilling greyed out, with the words "Requires a paid license".
  • A hosting account for the store. Its main domain is the address the store will live at (yourbrand.com, or a name such as shop.yourbrand.com), and that name points at the server. NimboBilling takes over the root of the site, so use an account that has no other website. It always uses HTTPS.
  • PHP 8.3 or newer on that account. If the account runs an older version the install card warns you; change it under PHP Version first.
  • Your own session. Do not install it after using Log in to open a customer's panel.

Install it, step by step

  1. In Accounts, open Manage → Apps on the account. A shortcut: Search tools has "Sell hosting (NimboBilling)", which takes you to Accounts and has NimboBilling already chosen when the Apps window opens.
  2. Choose NimboBilling in the list. Its card says what it is and what it needs, and every box has a line of help.
  3. Fill in the form. There is no folder box, because NimboBilling always takes the main address of the domain:
    • Site title — the name of your store.
    • Your name — shown inside the app only. You sign in with your email address, not with this name.
    • Admin email — what you sign in with, and where the app sends its messages to you.
    • Admin password — type one with at least 12 characters, letters and numbers, or leave it empty to have a strong one made for you.
    • Language — the language the app's admin starts in, and the default language of the store: English or Bahasa Indonesia. The choice also sets the currency and the time zone the store starts with. English starts with US dollars and UTC; the other language starts with the currency and time zone that usually go with it. You can change all three later (see below).
  4. Press Install. It takes about a minute.

If the domain already has a site

The panel asks before it does anything. A dialog titled Replace the site on this domain? lists the files it found and says what happens: NimboBilling becomes the site of the domain, the site that is there now stops being served as soon as the install finishes, and your files are not deleted, except any with the same name as one of the app's own files, which are replaced. Removing NimboBilling later empties the folder. The safe button, Cancel, is the one that has the focus. To keep the old site, cancel and install NimboBilling on a new hosting account or domain, or take a backup first.

The card after the install

The card shows the store address and the admin address, your email, your name and the password, each with a Copy button. Save the password now: it is shown only once.

Both addresses are secure (https) addresses. The certificate of a new name takes a few minutes, so until it is ready the card shows the addresses as plain text, with a note, and turns them into links by itself when the certificate is active (it says "The secure address is ready"). Opening the store before that shows a certificate warning.

A second card says NimboBilling is connected to this panel. During the install the panel made an API token for the store, named NimboBilling, with access to Accounts (read and change), and the store registered this panel with it, so a paid order can create a hosting account with nothing more to set up. The token is listed under API tokens, where you can revoke it, and it is revoked when the app is removed. To check the connection, open Services → Panel servers in NimboBilling and press Test connection. If the panel could not make the token, the card lists the steps to connect the two by hand. The app's scheduler line is added to the account's Cron Jobs for you; if that failed, the card shows the line to add.

One more line on the card matters: customers will see no way to pay until you add your bank details under Settings → Gateway: Manual transfer.

What a new store contains

A new install is filled once with a sample store, so the menus of the store work at the first visit instead of leading to empty pages:

  • sample plans in four groups: shared hosting, VPS servers, a dedicated server and domain names,
  • a starter help center with articles on ordering, payments, services and your account,
  • a few blog posts, published, and two announcements that stay drafts until you publish them.

Every name, specification and price in it is an example. The sample plans are listed in US dollars, or in the store's currency when you chose the other language at install. The hosting and server plans have no panel server attached, so an order for one waits for your staff until you link a product to your panel server and to the exact name of one of your packages (the product's Panel server and Package name on the panel). Replace the sample plans with your own, or delete them, before you open the store. Nothing brings them back: the store records that the sample was offered once.

Getting your store ready

From NimboBilling 1.0.7 a new store requires two-factor sign-in for every staff member: the owner's first sign-in goes straight to setting it up. A store installed before 1.0.7 is not switched over; its dashboard recommends it to the owner, and the setting is Settings → Security → Require 2FA for all staff.

The dashboard of the admin shows a card, Getting your store ready, until every step is done. Each step is ticked from the data itself, not by hand:

  1. Connect your hosting panel — only shown if the install did not already connect it. Services → Panel servers.
  2. Add your company email — shown on invoices and used by customers to reach you. Settings → General.
  3. Set up outgoing email (SMTP) — without it invoices and reminders do not reach customers. Settings → Email (SMTP).
  4. Set up payment: start with bank transfer. See below.
  5. Replace the sample plans with your own. The step counts as done when a plan of your own exists, or when you have edited a sample one.
  6. Choose your store's look — under Theme, logo & slides, pick a ready-made template, then adjust colours, fonts and logo.

Prices, markup and referrals

A price in the store is the product's base price plus a markup. Under Settings → Billing & Pricing, Default markup (%) is 10% to start with, and a single product can carry a figure of its own on its page. The markup is what funds referral commissions: they are off until you enable them under Settings → Referrals & Commissions, and they can reach up to five levels.

Add a markup to selling prices is the switch. With it off, every product sells at its base price and there is no money for referral commissions. It applies to new orders and the renewals after them; invoices that were already issued do not change. From NimboBilling 1.0.7 the sample plans of a new store follow the default markup too, so turning the switch off shows at once on their prices (a plan of USD 3.99 sells at 4.39 with the 10% default). A store installed with an earlier version keeps sample plans with a markup of their own set to 0%. When a staff member places an order at a price above the catalog while the switch is off, the difference counts as base price, not as markup, so it funds no referral commission.

Tax

Tax is off until you switch it on: Settings → Billing & Pricing → Charge tax (VAT/GST). Rates live under Tax rules. Its Common tax rates block adds the standard national rate of one of 18 countries with one click. That only creates a rule, it never turns tax on, and rates change, so confirm them with your accountant. For sales inside the EU you can also set your own country, turn on reverse charge for business customers, and have a customer's VAT number checked against the European Commission's VIES service (on by default; when VIES cannot be reached the number counts as unverified, VAT is charged, and staff can mark it verified by hand).

Time zone and language

Settings → General holds the Time zone of the store. The dates and hours in the admin, the customer pages, PDFs and emails, and the hour of the daily automatic billing run follow it. Set it before the first invoices: stored dates do not change when you change the zone, so an invoice's due date can show one day earlier or later afterwards, and the setting says so.

The same page has Admin panel language (English or Bahasa Indonesia), which applies to the menus, forms and Manual of the admin for all your staff. The texts of the store itself are kept in the store's main language, the one chosen at install, and fields that hold that text say (main language) in the English admin; from NimboBilling 1.0.7 the sample store is written in that language too. It does not change the language customers see; that is under Settings → Language. The default currency is on this page too, together with the currencies customers may choose.

Payments

Gateways are set under Settings, one page each.

  • Bank transfer comes first because it needs no gateway account. It is switched on from the start, but customers are offered it only once you replace the example in Settings → Gateway: Manual transfer with your real bank details. The customer uploads a proof of transfer and your staff approve it under Payments.
  • Stripe (cards): Settings → Gateway: Stripe (cards). It has a test mode; use it first.
  • PayPal: Settings → Gateway: PayPal, with a sandbox switch.

For Stripe and PayPal the settings page shows a Webhook URL and the events to select. Add it at the gateway, or a payment made after the customer closed the tab is confirmed late.

What is proven. Stripe is proven in its test mode only. PayPal is not yet proven end to end with a real payment. Make one small real purchase yourself before you advertise the store. The app's own Manual / guide has the step-by-step for each gateway.

Updating

When a newer version of NimboBilling is in the catalog, Manage → Apps shows Update available next to it and an Update button. The panel takes a backup first, replaces the application code, keeps your .env configuration, runs the app's own upgrade, and checks that the site answers. If it does not come up cleanly, the panel puts the old version back and says your site is unchanged. Your products, customers, invoices and settings stay as they are. A store installed before a version does not get new sample texts written into it.

Removing it

Manage → Apps → Remove, then type remove to confirm. This deletes the files and the database of the store, with its invoices, customers and tickets, so make a backup first. The folder is left empty, and the API token the store used is revoked. The hosting accounts it created are accounts of the panel and are not part of the app.

When something is off

  • The card says the folder already has files. Read the dialog above, and choose a new account if you want to keep the site that is there.
  • The store address shows a certificate warning right after the install. Wait a few minutes: the card turns the links on when the certificate is ready.
  • Customers see no way to pay. Add your bank details under Settings → Gateway: Manual transfer, or switch on a gateway.
  • A paid order did not create an account. Open the product and check that it is linked to your panel server and to the exact name of one of your packages. A sample plan is not. See also the connection check above.
  • The install is refused for PHP. The account runs a version below 8.3. Change it under PHP Version and install again.
  • NimboBilling is greyed out in the list. The server is on the Free tier; see How licensing works.

Related: Marketing website · Reseller guide · How licensing works · Troubleshooting