Sensei: Installing

Note

Sensei Freemium 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


Connect to Your Firewall

$ ssh root@your-firewall-ip

After a successful login, enter “8” as the option to drop to the shell

../../_images/opnsense-terminal-1.png

Download & Run Sensei Installer

Run the following one-liner command to download and invoke the installer script.

root@fw:~ # curl https://updates.sunnyvalley.io/getsensei | sh
../../_images/opnsense-terminal-3-getsensei-1.png

Hence we passed the downloaded script to sh, it will automatically run the installer script.

Installing via OPNsense installer
Do you wish to install Sensei? y

Install script will copy the installation files onto the filesystem and will add a menu item within the Firewall Web User Interface. Depending on your computer setup and your internet connection speed, it might take 1-4 minutes to complete.

Note

You can get detailed info about suggested hardware on Sensei: Hardware Requirements

../../_images/opnsense-terminal-3-getsensei-2.png

Once the install is completed, you can disconnect from your terminal, and disable your firewall’s ssh service by unchecking the checkboxes mentioned above.


Initial Configuration Wizard

Note

To start using Sensei, first, you need to go through the Wizard which will guide you to start with the best initial configuration.

To start your “Initial Configuration Wizard”;

  • Log in to your OPNsense Web UI,
  • Click Sensei from the left menu,
  • Click on the Dashboard sub-menu. It will open up the Wizard.

1- EULA

  • Accept the End User License Agreement (Scroll & read the terms to get to the next button).
  • Click Next and get to the Interface Selection section.
../../_images/sensei-0-wizard-tab1-welcome-1.png

2- Interface Selection

  • Select the Ethernet Interfaces to protect. To do that, click on an interface and use the right/left arrow buttons to move it to protected/unprotected interfaces combo box.
  • Click Next and get to the Cloud Reputation section.
../../_images/sensei-0-wizard-tab2-interface-selection-2.png

3- Cloud Reputation

The Cloud Threat Intelligence data is queried real time when anyone makes a connection through your network. It enables us to respond to malware and wireless outbreaks in real time and very fast.

The engine processes the request, queries to SVN Cloud in real-time and decides whether it will be blocked or allowed. We check against 140+ Million Websites, under 120+ categories in milliseconds.

Cloud Threat Intel settings let you;

  • Enable/Disable the cloud reputation & web categorization engine
  • Set local domain settings to be excluded from cloud queries
../../_images/sensei-0-wizard-tab3-cloud-reputation-2.png

4- Sensei CLI (Security)

  • Set your TCP Service password. This password protects the command line based CLI access to the packet engine. It is highly recommended to set this with a secure one.
  • Click “Next” and get to the “Updates” .
../../_images/sensei-0-wizard-tab4-sensei-cli.png

5- Updates & Health Check

Note

Sensei uses OPNsense package system to deliver its updates. Configure the way you receive your Sensei updates as you feel convenient.

  • Self Health Check: If enabled, “Self Health Check” monitors the system’s memory, CPU, disk usage and core services if they’re working correctly, and raises alerts if anything goes wrong. Self Health Check also stops the relevant services if they’re consuming excessive system resources.
  • Check for Updates Automatically: Checks automatically for the updates and creates a notification on the status page.
  • Update Databases and Threat Intelligence Data Automatically: Checks automatically for the updates and creates a notification on the status page .
  • Enable Generation of Support Data: If enabled, Sensei collects supporting data during unusual events and crashes. You can share this data while opening a ticket with us.
../../_images/sensei-0-wizard-tab5-updates-health-check.png

6- Deployment Size

Sensei supports up to 1,000 concurrent users on an everyday PC. You can set your Sensei installation’s capacity here.

Note

You can get detailed info about suggested hardware on [Getting Started > Hardware Requirements​](getting-ready.md)

../../_images/sensei-0-wizard-tab6-deployment-size-1.png

7- Finish

Click the Finish button to save your initial configuration data and start using Sensei.

../../_images/sensei-0-wizard-tab7-finish-1.png

Hands-on Video