OSIR · The AI-Native Domain Registrar

Integrations / FOSSBilling

Sell domains from your FOSSBilling, registered through OSIR

A free, open-source registrar plugin for FOSSBilling. Your customers search, register, transfer and renew domains in your billing system; OSIR registers them and charges your reseller balance.

Download the plugin · Read the setup guide · Source on GitHub

Version 1.2.1, Apache License 2.0, free and open source.

What you get

Every domain operation

Registration, transfer-in with auth code, renewal, nameservers, contacts, transfer lock, WHOIS privacy and transfer codes, all from FOSSBilling.

DNS your customers manage themselves

Every domain your customers hold with you gets a DNS page in your client area, where they add and edit A, AAAA, CNAME, MX, TXT and other records themselves. It comes with the domain they already bought: nothing extra to sell, invoice or configure. The domain’s own nameserver records stay with us, so nobody takes their zone offline by accident.

Your prices, set in minutes

Import OSIR's TLDs with your markup: a percentage, a fixed amount, rounded to .99 if you like. You see your cost and your price before anything is saved.

Bring your existing domains

Domains you already hold at OSIR become FOSSBilling orders for the right customer, with their real expiry date. Nothing is re-registered or charged.

Charged once, even when things go wrong

A lost connection, a retried cron run or a double click never registers or renews twice. An optional price limit stops anything above your cost cap.

Secure by design

Your API key is never logged or shown again, certificates are always verified, and customers never see your balance or account details.

Optional OSIR theme

A clean storefront theme with domain search on the home page, and the DNS tab on the domain page. Use it, adapt it, or keep your own and add the one-line DNS link from the README.

What it looks like

FOSSBilling OSIR import screen showing TLDs with OSIR cost and the reseller selling price side by side before import
Import OSIR TLDs with your markup. You see your cost and your price before anything is saved.
FOSSBilling registrar settings for the Osir adapter, with the API key field masked
The registrar settings. The API key is masked once saved and never written to logs.
FOSSBilling OSIR import screen listing existing OSIR domains ready to be assigned to customers as orders
Domains you already hold at OSIR become orders for the right customer, with their real expiry date.
FOSSBilling storefront home page using the optional OSIR theme, with a domain search box above the fold
The optional OSIR theme puts domain search on the home page. Your own theme works just as well.
Customer view of a single domain in FOSSBilling, showing nameservers, contacts, transfer lock and WHOIS privacy
What your customer sees: nameservers, contacts, transfer lock and privacy, with no OSIR branding.
FOSSBilling storefront with the OSIR theme on a mobile phone screen
The theme is responsive down to phone width.

What you need

  • FOSSBilling 0.8.7 or newer
  • PHP 8.3, 8.4 or 8.5
  • Served over HTTPS
  • FOSSBilling's cron running every 5 minutes
  • An OSIR reseller account with a funded balance and an API key

Get started

Five steps, about 20 minutes. You need FOSSBilling 0.8.7 or newer and an OSIR reseller account with a funded balance.

  1. Create your API key. In the OSIR panel, create an API key (it starts with osir_live_) and ask us to restrict it to your server's IP address.
  2. Install the plugin. Download osir-fossbilling-registrar-1.2.1.zip from the latest release, check it against SHA256SUMS, and extract it into your FOSSBilling folder. It only adds files.
  3. Connect it. In the FOSSBilling admin panel, open Domain Management then Registrars, find Osir, click Install, and add your API key. Keep Test Mode off.
  4. Set your prices. Activate the OSIR import module under Extensions, then open System, then OSIR import. Choose your TLDs and your markup, preview the prices, and import.
  5. Try it on yourself. Register one inexpensive domain for your own account. When it shows as active, you are ready to sell.

Already hold domains at OSIR? Import them in step 4 on the Domains tab: they become orders for the right customers, with nothing charged.

Frequently asked questions

What does the plugin cost?
Nothing. It is free and open source under the Apache License 2.0. You pay OSIR’s reseller price for each registration, renewal and transfer, taken from your OSIR balance, and you set your own selling prices.
What do I need to run it?
FOSSBilling 0.8.7 or newer on PHP 8.3, 8.4 or 8.5, served over HTTPS, with FOSSBilling’s cron running every 5 minutes. On the OSIR side: a reseller account with a funded balance and an API key.
Can my customers manage their own DNS records?
Yes, from version 1.2.1. Each domain a customer holds with you gets a DNS page in your client area where they list, add, edit and delete A, AAAA, CNAME, MX, TXT and other records for that one domain. It is included with the domain they already bought, so there is no separate plan to sell, no extra order and no invoice. Records are validated before anything is sent, and the zone apex is protected: the SOA record and the domain’s own nameserver records cannot be changed or deleted, so a customer cannot take their own zone offline. A customer only ever sees the DNS page for their own domains, and only for domains registered through OSIR. This is per-domain record editing for the customer, not a DNS hosting product and not a bulk zone editor for you.
Which domain extensions can I sell?
The whole OSIR catalog, around 450 TLDs. You choose which ones to offer and at what price.
How do I set my prices?
On the OSIR import page, pick TLDs and a markup: a percentage, an optional fixed amount, and rounding to .99 or a whole amount. You see OSIR’s cost including fees and your selling price before saving. Prices are imported in US dollars, so FOSSBilling’s default currency must be USD. You can still edit any price by hand afterwards.
Is there a test or sandbox mode?
No. OSIR has no test environment, so the plugin refuses to run while FOSSBilling’s Test Mode is on and sends nothing. To try it, register one inexpensive domain for yourself.
What if the connection drops during a registration or renewal?
You are charged once. Every registration, renewal and transfer carries a unique key, so a retry, a repeated cron run or a double click gets the result of the first attempt instead of a second charge. If something cannot be confirmed, the order is left for you to check, never guessed.
Can I limit what a single domain may cost me?
Yes. Set a maximum cost per year. Before any charge, the plugin asks OSIR for the price, and anything above your limit is refused.
How do renewals work?
FOSSBilling invoices your customer before the domain expires. When the invoice is paid, the plugin renews the domain at OSIR. OSIR’s own automatic renewal is switched off for these domains, so you and your customer stay in control. A renewal paid shortly after expiry is still completed while the registry allows it.
Can my customers transfer domains to me?
Yes. They order a transfer in your shop and enter the transfer (auth) code from their current registrar.
I already have domains at OSIR. Can I manage them in FOSSBilling?
Yes. The import brings them in as orders for the customer you choose, with their real expiry date, nameservers and contact details. Nothing is registered again and nothing is charged.
What about premium domains?
They are refused at checkout. FOSSBilling has no premium pricing, so you would otherwise sell a premium name at the standard price.
What happens if an order is cancelled?
The domain is not deleted. It stays registered until its expiry date.
Do my customers see OSIR?
No. Your customers use your FOSSBilling, with your brand. The plugin shows them no OSIR branding, and its error messages never reveal your balance or account details.
Is my API key safe?
The key is never written to logs or shown again after you save it, connections to OSIR always verify certificates, and the key can only be sent to OSIR’s API. We recommend keeping it in FOSSBilling’s configuration file and asking us to restrict it to your server’s IP address.
Do I have to use the OSIR theme?
No, but there is one thing to know since version 1.2.1. The theme gives you a storefront with domain search on the home page, and it puts the DNS tab on the domain page in the client area. FOSSBilling’s domain page cannot be extended by a module, so that link has to come from a theme. On your own theme the DNS page still works exactly the same; you just add the link yourself, and the README has the one-line snippet for it.
Where do I get help?
Contact OSIR support and include the reference number shown in any error message. Report security issues privately through the same channel, marked "security".