Service options

Product and service options

BlissRADIUS Embedded products and services are configured using special options. Configuration can be written as plain text found in .ini or config files. Each option is listed in separate line as name = value. Option names are case insensitive and spaces are not important, eg. GBLimit, gblimit and GB limit are all the same. If same option is listed more than once then last line takes precedence. See configuration examples.

General options

• Permanent - (yes/no) - should service be permanent (have no duration limit), default is no. In most cases you want to set it to yes and let host software enable/disable service.
• Duration months - (integer) - number of months non permanent service lasts before it is terminated, default is 0. If used with Duration days then both periods are added. Permanent must be set to no for this option to have effect.
• Duration days - (integer) - number of days non permanent service lasts before it is terminated, default is 0. If used with Duration months then both periods are added. Permanent must be set to no for this option to have effect.
• Port limit - (integer) - number of simultaneous online sessions per service, default is 1
• Framed IP - (text) - list of single IPv4/IPv6 addresses, IPv4 ranges or pool names to assign, eg. 10.4.4.117, 2001:ffaa::, 10.0.0.10-255, 192.168.0.1-32, mypool Default is empty meaning RADIUS will assign address depending on NAS or global Framed IP settings. IPv6 ranges are not supported for now. Pool support was added in version 1.14.
• Session attributes - (text) - list of RADIUS attributes set for all modes, multiple values are separated with \n (literal, escaped new line character), eg. Idle-Timeout=86400 \n Mikrotik-Rate-Limit=512k/5M. These attributes are set only on session start and may be overridden by NORMAL, SPECIAL or LIMITED attributes.
• Calling ID login - (yes/no) - should service be authenticated by CallingID/MAC stored as username, default is no meaning authentication requires correct username and password.
• Notifications - (text) - list of usage thresholds that will trigger email notifications, written in format PERCENT% OPTION, eg. 50% Hourly limit, 90% GB limit. Depending on Notification methods option, email and SMS messages may be sent to user. Percent is integer number only, no decimals.
• Notification methods - (text) - comma separated list of notification methods to use, default is SMS, email which enables all possible methods. Method names are case insensitive. If value is blank default will be used.
• NAS access - (text) - comma separated list of NAS ID's or NAS names matched by * wild card that are permitted to be used by this service for authentication, eg. 1, 3, *public*. Default is blank value, meaning service can connect from any NAS.

NORMAL mode options

• Normal attributes - (text) - list of RADIUS attributes for NORMAL mode, syntax is same as in Session attributes. These attributes are set on NORMAL session start and on NORMAL mode change.

SPECIAL mode options

• Special attributes - (text) - list of RADIUS attributes for SPECIAL mode, syntax is same as in Session attributes. These attributes are set on SPECIAL session start and on SPECIAL mode change.
• Disconnect special - (yes/no) - should services in SPECIAL mode be disconnected, default is no
• Special hours - (text) - list of hours (0-23) during which service switch to SPECIAL mode, eg. 0-8, 13, 14, 20-23.
• Special days of month - (text) - list of days of month (1-31) during which service switch to SPECIAL mode, eg. 1, 2, 3, 25-31.
• Special days of week - (text) - list of days of week (0-6 where 0=Sunday, 1=Monday, ..., 6=Saturday) during which service switch to SPECIAL mode, eg. 0, 6 for Sunday and Saturday.
• Special dates - (text) - comma separated list of dates in YYYY-MM-DD format during which service switch to SPECIAL mode for the duration of whole day. * can be used as wild card to match part of date, eg. 2001-01-01, 2001-04-*, *-12-31, *-03-* would match exact day of January 1st 2001, whole month of April 2001, December 31st of any year and every day of March of any year.
• Special GB percent - (integer) - percent (0-100) that control how to count GB used in SPECIAL mode towards quota, default is 100. Use this if you want to give discount for GB transfer.

LIMITED mode options

• Limited attributes - (text) - list of RADIUS attributes for LIMITED mode, syntax is same as in Session attributes. These attributes are set on LIMITED session start and on LIMITED mode change.
• Disconnect limited - (yes/no) - should services in LIMITED mode be disconnected, default is no.
• Calendar monthly limit - (yes/no) - if yes then monthly limits are calculated from first day of month, otherwise limits are calculated from day service was created, default is yes.
• Monthly data rollover - (yes/no) - if yes then left over from previous month is added to monthly limits, default is no, amount is never greater than monthly limit.
• Hourly limit - (decimal) - amount of hours online service has before it switch to LIMITED mode.
• Download limit - (decimal) - amount of GB of download service has before it switch to LIMITED mode.
• Upload limit - (decimal) - amount of GB of upload service has before it switch to LIMITED mode.
• GB limit - (decimal) - amount of GB of download + upload service has before it switch to LIMITED mode.
• Daily hourly limit - (decimal) - amount of hours per day, counter is reset on midnight.
• Daily download limit - (decimal) daily download limit in GB.
• Daily upload limit - (decimal) daily upload limit in GB.
• Daily GB limit - (decimal) daily download + upload limit in GB.
• Monthly hourly limit - (decimal) - amount of hours per month, depending on Calendar monthly limit option, counter is reset on midnight of first day of month or day when service was created.
• Monthly download limit - (decimal) monthly download limit in GB.
• Monthly upload limit - (decimal) monthly upload limit in GB.
• Monthly GB limit - (decimal) monthly download + upload limit in GB.

Extra syntax

• Session attributes, Normal attributes, Limited attributes and Special attributes options have extra syntax to append single RADIUS attributes in form of option > attribute = value eg. Session attributes > Idle-Timeout = 1800 Unlike option name, RADIUS attribute part is case sensitive.

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.