Skip to main content

Installation

You can install Sensei on variety of platforms for trying it free. These supported platforms are:

info

Sensei can deploy onto any Cloud environments either as a gateway or on a per-server basis.

IMPORTANT NOTE:

Before installing Sensei, you should ensure you meet the minimum system requirements in order to run Sensei or to have the best user experience. See Hardware Requirements for more information.

note

Sensei Free Edition is forever free-of-charge. We strongly recommend you register to keep in touch with updates and new features. You can register at https://www.sunnyvalley.io/sensei.

OPNsense#

Installing on OPNSense

Sensei Free Edition is forever free-of-charge. We strongly recommend you register to keep in touch with updates and new features. You can register at https://www.sunnyvalley.io/sensei.

Sensei may be installed using the web interface in OPNsense or using the command line interface via SSH or local system access (see instructions here). The preferred method is the web interface. Once Sensei is installed, you will need to complete the initial configuration in the web interface so it is convenient to also complete the installation using the web interface.

To install plugins in OPNsense, you must use an account with administrative access.

Before installing Sensei, you should ensure you meet the minimum system requirements in order to run Sensei or to have the best user experience. See Hardware Requirements for more information.

Web Interface Installation#

To install Sensei, you must first install the Sunny Valley Networks vendor repository plugin. Go to the System --> Firmware --> Plugins page. Click on the + icon next to os-sunnyvalley to install the plugin.

Once the vendor plugin is installed, you should see the Sensei plugin available in the list of plugins as os-sensei. If you do not see the Sensei plugin, you may need to refresh the Plugins page. Click the + icon next to os-sensei to install the plugin.

After installing Sensei, you should see the Sensei menu in the left sidebar of the OPNsense web interface. If you do not see the new, top-level menu, you may need to refresh the page.

sensei-install-complete.png

Figure 1. Installed Sensei Plugins on OPNsense

Next, you will need to complete the Initial Configuration Wizard for Sensei to be fully operational.

Initial Configuration Wizard is quite self-explanatory; but if you still need detailed guide, please read on here:

Hands-on Video#

FreeBSD#


Installing on FreeBSD

To install Sensei on FreeBSD, just run below one-liner which will install the package repository and the main package:

curl https://updates.sunnyvalley.io/getsensei.sh -o getsensei.sh && sudo sh ./getsensei.sh

Authenticate & register your FreeBSD node to the Cloud Central Manager

(*) Sign-up for a new account from the Cloud Central Management Portal if you've not done so yet. For more information about creating a portal account, click here.

To register your FreeBSD node to the Cloud Central Manager run the following command as root or user with sudo privileges:

sudo senseictl cloud register

As a final step, complete the Initial Configuration of your FreeBSD firewall for the cloud portal by following the instructions.


Ubuntu#

Installing on Ubuntu

To install Sensei on Ubuntu, just run below one-liner which will install the package repository and the main package:

curl https://updates.sunnyvalley.io/getsensei.sh -o getsensei.sh && sudo sh ./getsensei.sh

Authenticate & register your Ubuntu node to the Cloud Central Manager

(*) Sign-up for a new account from the Cloud Central Management Portal if you've not done so yet. For more information about creating a portal account, click here.

To register your Ubuntu node to the Cloud Central Manager run the following command as root or user with sudo privileges:

sudo senseictl cloud register

As a final step, complete the Initial Configuration of your Ubuntu firewall for the cloud portal by following the instructions.


CentOS#

Installing on CentOS

To install Sensei on CentOS, just run below one-liner which will install the package repository and the main package:

curl https://updates.sunnyvalley.io/getsensei.sh -o getsensei.sh && sudo sh ./getsensei.sh

Authenticate & register your CentOS node to the Cloud Central Manager

(*) Sign-up for a new account from the Cloud Central Management Portal if you've not done so yet. For more information about creating a portal account, click here.

To register your CentOS node to the Cloud Central Manager run the following command as root or user with sudo privileges:

sudo senseictl cloud register

As a final step, complete the Initial Configuration of your CentOS firewall for the cloud portal by following the instructions.


Debian#

Installing on Debian

To install Sensei on Debian, just run below one-liner which will install the package repository and the main package:

curl https://updates.sunnyvalley.io/getsensei.sh -o getsensei.sh && sudo sh ./getsensei.sh

Authenticate & register your Debian node to the Cloud Central Manager

(*) Sign-up for a new account from the Cloud Central Management Portal if you've not done so yet. For more information about creating a portal account, click here.

To register your Debian node to the Cloud Central Manager run the following command as root or user with sudo privileges:

sudo senseictl cloud register

As a final step, complete the Initial Configuration of your Debian firewall for the cloud portal by following the instructions.


pfSenseĀ® software#

Installing on pfSenseĀ® software

To install Sensei on pfSenseĀ® software, just run below one-liner which will install the package repository and the main package:

curl https://updates.sunnyvalley.io/getsensei.sh -o getsensei.sh && sh ./getsensei.sh

Authenticate & register your pfSenseĀ® software node to the Cloud Central Manager

(*) Sign-up for a new account from the Cloud Central Management Portal if you've not done so yet. For more information about creating a portal account, click here.

Make senseictl utility visible for the csh shell.
rehash
Cloud Registration Command
senseictl cloud register

As a final step, complete the Initial Configuration of your firewall for the cloud portal by following the instructions.


AlmaLinux#

Installing on AlmaLinux

To install Sensei on AlmaLinux, just run below one-liner which will install the package repository and the main package:

curl https://updates.sunnyvalley.io/getsensei.sh -o getsensei.sh && sudo sh ./getsensei.sh

Authenticate & register your AlmaLinux node to the Cloud Central Manager

(*) Sign-up for a new account from the Cloud Central Management Portal if you've not done so yet. For more information about creating a portal account, click here.

To register your AlmaLinux node to the Cloud Central Manager run the following command as root or user with sudo privileges:

sudo senseictl cloud register

As a final step, complete the Initial Configuration of your AlmaLinux firewall for the cloud portal by following the instructions.