Installation

Please walk through the following steps. If you encounter any issues during installation, refer to our Troubleshooting Guide.

Preparation

Ubuntu 22.04 or Ubuntu 24.04

Step #1 - (Optional) Create a new user that will own all the installed files and run the Sandbox services

sudo adduser --disabled-password --gecos "" sandbox

Step #2 - Download and unpack the release archive to a folder, e.g.: your home folder

Install 7zip:

sudo apt-get update

sudo apt-get install p7zip-full -y

RedHat 9.5

Step #1 - Install EPEL repositories (if they are not yet available)

sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm -y

Step #2 - (Optional) Create a new user that will own all the installed files and run the Sandbox services

sudo useradd --create-home sandbox

sudo passwd -l sandbox

Step #3 - Download and unpack the release archive to a folder, e.g.: your home folder

Install 7zip:

sudo dnf update -y

sudo dnf install p7zip -y

Installation

Step #1 - Download the product:

Download the release archive from https://my.opswat.com/portal/products

Note that the release archive is password protected and needs to be unpacked.

7za x -aoa -p"PASSWORD" MetaDefender_Sandbox_vx.y.z-Standalone.zip

Step #2 - Move to the installation folder:

cd sandbox-installer

Step #3 - (Optional) Edit install.cfg to specify a custom user name and installation path

Note: The default settings work fine for standard deploys and all features can be configured post installation.

More details are available in Installation Options.

Step #4 - Run the install shell script

Note that this operation can take up to 20-30 minutes (depending on available network bandwidth).

sudo ./install.sh

The first step of the installation process is accepting the product EULA, you need to press Y to start the installation.

Step #5 - Access the Sandbox web server (https://localhost:443) and setup the initial Admin user

Step #6- Add your Activation Key

The system will not be able to generate scan reports yet, as a valid Activation Key is required.

Please use the Activation Key that you received from your OPSWAT Sales Representative, and follow the instructions on the License Activation page.

Simple steps for Online activation:

Navigate to the Admin panel > Settings > Integrations > License Management tab, then click on Activate All, then enter your license key!

Step #7 - Scan your preferred test file to check if the Sandbox system functions properly

Step #8 - (Optional) Troubleshooting if the Sandbox service failed to initialize

Verify the status of the sandbox service and if the running docker container are healthy:

sudo service sandbox status

sudo docker ps

The sblog bash command can be used to check the application logs for different system components.

This command is available to all users (but might require sudo privileges):

# Show logs from the transform component

sblog 

# Show logs from the broker component

sblog -b

Important notes for air-gapped systems

Please see the Air-gapped Systems subpage.