Installing in generic mode

Installing in generic mode / custom integration

BlissRADIUS Embedded can be custom integrated with your own built billing software. Once customization is complete, installation process is straight forward and similar to any other platform.

General preparations

1. Download archive for your OS and architecture to computer where you wish to install BlissRADIUS Embedded. Extract program file to installation folder, /blissembed on Linux or c:/blissembed on Windows. Program file is blissembed.exe or blissembed respectively.

2. On Linux OS make sure program file has execute privilege. If needed run shell command chmod a+x blissembed from created folder.

3. Create blissembed.cfg file in folder with program and configure correct values (see example below). You must not skip this step. Configuration file must contain line hosttype = generic

4. Add write privileges to program folder for BlissRADIUS Embedded to be able to write files in it.

Host API security and access

1. If you have some form of IP address and password security protection for API calls in your billing software, don't forget to add 127.0.0.1 as address and username blissembed with password blissembed as API parameters BlissRADIUS Embedded is using by default when connecting to your software.

Connecting with database

1. If you are using Postgres or MySQL database of your billing software to store data, then you need to create database user accounts and let BlissRADIUS Embedded know of connection parameters (they are set in config file, see examples below).

Configuring BlissRADIUS Embedded

1. Open BlissRADIUS Embedded web interface on http://127.0.0.1:9071 using browser (change address if not accessing from local computer). By default BlissRADIUS Embedded uses admin as password for web interface and all access from local addresses 127.0.0.1 and ::1 doesn't requires login.
2. Go to Config page in BlissRADIUS Embedded web interface and set correct parameters for your billing software API receiver:
   • Host API URL should point to billing API access, for local computer it may be something like http://127.0.0.1/my_billing/api
   • Set API username and API Password to blissembed
   • Add IP address of your billing software to Trusted IP Address field if it is other than 127.0.0.1 or ::1
3. Confirm that configuration is correct by clicking on Test API button

You have successfully connected BlissRADIUS Embedded with your billing software and two way communication is working.

Example blissembed.cfg

This is example configuration for testing. SQLite database in local file is used to store data separately from your billing software.

hosttype = generic
dbtype = sqlite

This is example configuration for production. Data is stored in same MySQL database where your billing software stores data. Change database parameters to match correct values. You can also use different database engine instead, see all command line options for supported database types.

hosttype = generic
dbtype = mysql
dbhost = 192.168.100.10
dbport = 3306
dbname = blissembed
dbuser = blissembed
dbpass = blissembed

Creating MySQL user account

Creating new MySQL role and granting privileges is required only if you are using BlissRADIUS Embedded with MySQL. Username and password must be same as in blissembed.cfg Replace localhost with IP address where BlissRADIUS Embedded is installed if they are not on same computer.

CREATE USER 'blissembed'@'localhost' IDENTIFIED WITH mysql_native_password BY 'blissembed';
GRANT ALL PRIVILEGES ON blissembed.* TO 'blissembed'@'localhost';

If you receive "The authentication plugin is not supported" error during program start make sure user is identified with correct plugin, as BlissRADIUS Embedded uses mysql_native_password. You might need to change my.cnf file and re-create user if example above don't work:

[mysqld]
default-authentication-plugin=mysql_native_password

2025-03-16

Referral program is active, existing users can win bonus license time if they bring new customers in.

2025-03-02

BlissRADIUS Embedded™ 1.16 is out with new features.

2024-09-27

BlissRADIUS Embedded™ 1.15 is out with postpaid license support.

2024-09-19

We are introducing changes to payment methods. See Home page for more details.

2023-07-06

BlissRADIUS Embedded™ 1.14 is out with new features.

2022-11-18

BlissRADIUS Embedded™ 1.13 is released with new fixes and features.

2021-12-31

BlissRADIUS Embedded™ 1.12 is out with new features.

2021-06-22

Volume discount for monthly BlissRADIUS™ licenses is available now.