Installing with UISP

Installing with Ubiquiti UISP

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 = uisp

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

UISP API access

1. Log in to UISP staff area to System -> Security and create App key with read access. Write access is not needed at the moment. Store key for later use. All communication is done via API calls initiated only from BlissRADIUS Embedded's side.

Connecting with database

1. If you are using MySQL database of UISP host to store data, then you need to create MySQL user account (see below). If you are only testing BlissRADIUS Embedded then you can skip this step and use SQLite database instead.

Starting program

1. Run BlissRADIUS Embedded by typing console/shell command: blissembed.exe or ./blissembed depending on your OS. This will start program in debug mode. For production use correct starting procedure.

2. There is no need to copy any files to UISP side, as all communication is done via API calls only. There is no separate plugin or module for UISP integration nor there is need to perform any additional steps.

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 require login.

2. Go to Config page in BlissRADIUS Embedded web interface and set correct parameters for UISP host:

   • Host API URL should point to UISP API access, for local computer it is https://127.0.0.1/crm/api/v1.0 (no trailing slash character). Path may differ depending on your UISP version and IP address.
   • Set API access key to App key you just created in UISP admin area.

3. Confirm that configuration is correct by clicking on Test API button.

You have successfully connected BlissRADIUS Embedded with UISP and communication is working.

Example blissembed.cfg

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

hosttype = uisp
dbtype = sqlite

This is example configuration for production. Data is stored in same MySQL database where UISP stores data. Change database parameters to match correct values.

hosttype = uisp
dbtype = mysql
dbhost = 192.168.100.10
dbport = 3306
dbname = uisp
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. Replace database name with one UISP is using.
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 uisp.* 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.