Skip to main content

Installation

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

info

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

IMPORTANT NOTE:

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

caution

To use all of the filtering functionalities of the Zenarmor, you must have either the netmap framework or nfqueue framework installed on your system. Although FreeBSD systems has installed netmap by default, Linux systems such as Ubuntu, CentOS and Debian does not include the netmap by default. On Linux distributions, you may use the default installed NFQ framework or install the netmap by yourself. For more information about how to install netmap on Linux, please refer to netmap installation guide.

note

Zenarmor 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.

Installing on OPNSense

Zenarmor 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.

Zenarmor 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 Zenarmor 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 Zenarmor, you should ensure you meet the minimum system requirements in order to run Zenarmor or to have the best user experience. See Hardware Requirements for more information.

Web Interface Installation

To install Zenarmor, you must first install the Sunny Valley Networks vendor repository plugin. Go to the SystemFirmwarePlugins page. Click on the + icon next to os-sunnyvalley to install the plugin.

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

After installing Zenarmor, you should see the Zenarmor 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.

For more information, please refer to Zenarmor Installation on OPNsense Web UI.

Installed Zenarmor Plugins on OPNsense

Figure 1. Installed Zenarmor Plugins on OPNsense

Next, you will need to complete the Initial Configuration Wizard for Zenarmor 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


Installing on FreeBSD

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

curl https://updates.sunnyvalley.io/getzenarmor | 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 zenarmorctl cloud register

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


Installing on Ubuntu

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

curl https://updates.sunnyvalley.io/getzenarmor | 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 zenarmorctl cloud register

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


Installing on CentOS

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

curl https://updates.sunnyvalley.io/getzenarmor | 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 zenarmorctl cloud register

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


Installing on Debian

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

curl https://updates.sunnyvalley.io/getzenarmor | 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 zenarmorctl cloud register

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


Installing on pfSense® software

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

curl https://updates.sunnyvalley.io/getzenarmor | 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 zenarmorctl utility visible for the csh shell.
rehash
Cloud Registration Command
zenarmorctl cloud register

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


Installing on AlmaLinux

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

curl https://updates.sunnyvalley.io/getzenarmor | 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 zenarmorctl cloud register

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

Hands-on Video

Here is a video that will guide you through the steps of the installation and registration process for BSD-based, such as pfSense® software, and Linux-based, such as Debian and Ubuntu, systems.