Skip to main content
All CollectionsSetup and ConfigurationServer
Deploy the NetBeez Server on-premise

Deploy the NetBeez Server on-premise

Instructions on how to deploy a NetBeez server as a virtual appliance.

Panickos Neophytou avatar
Written by Panickos Neophytou
Updated this week

NetBeez users can deploy a NetBeez server instance on their own on-premise infrastructure. The server will be delivered as a virtual appliance for VMware, HyperV, or KVM environments. The following procedure explains how to do this. If a NetBeez user prefers to deploy the server as an AWS instance, please follow this guide.

Server requirements for deployment

Below are the suggested server requirements (CPU and RAM) on the number of network agents managed by the dashboard (remote workers account for 1/2 a network agent). Please keep in mind that instance requirements change also based on the number of tests running, as well as type and interval. It's recommended to consult NetBeez support before deployment.

Number of network agents

CPU

RAM

HDD

0 - 10

2

8

200GB

11 - 60

4

16

61 - 100

8

32

500GB

101 - 200

16

64

1TB

201 - 500

32

128

2TB

501 - 1000

48

192

3TB

1001 - 2500

64

256

4TB

Prerequisites

Prior to getting the server deployed, you will need to do the following:

  1. A valid NetBeez license or contract

  2. VMware or other virtualization environment ready to go

  3. Decide on a FQDN and send it to success@netbeez.net

    • The FQDN entry should be resolvable via an A entry registered within the domain name system of the organization

  4. Decide on the network configuration:

    • Have a static IP address assigned to the server

    • Netmask

    • Gateway

    • DNS servers

    • Optional: NTP server

  5. Have rules in place on network firewalls to allow installation and update scripts to function and connect to NetBeez and third-party software repositories

Procedure

  1. Download the Ubuntu Server 22.04 image from Ubuntu's repository; alternatively, users can use their own template of the same OS and version

  2. Deploy the Ubuntu server 22.04 template on the VMware infrastructure, or preferred virtualization environment, and assign proper resources (consult the table above)

    • DO NOT update past 22.04

    • Skip ahead to Network Connections

      • Edit enp1s0 > IPv4

      • Change from (Automatic) DHCP to Manual

      • Configure Subnet, Address, Gateway, Name Servers (DNS)

    • Skip ahead to Guided Storage Configuration

      • Verify Storage information

    • Skip ahead to Profile Setup

      • Configure the login, name, and password

      • Optional: Sharing this info (username and password) with our support team allows us to deliver better support

    • Skip ahead to the SSH setup screen

      • Install OpenSSH server

    • Not recommended to install optional “Server Snaps”

    • Let the server finish & reboot

  3. Reach out to success@netbeez.net for the NetBeez install script

  4. Log in as root and run the NetBeez Install script as Sudo Su

    • This installation may take 30 or more minutes

  5. Once the script is completed, SSH back to the server

  6. Set the correct docker configuration by creating the following file:

    /etc/docker/daemon.json

    Add the following content to the file, then close and save:

    {
    "bip": "198.18.252.130/28",
    "fixed-cidr": "198.18.252.128/28",
    "default-gateway": "198.18.252.129"
    }

  7. Restart Docker services with the following commands:

    service docker restart
    nb-docker-compose down
    nb-docker-compose up -d
    watch docker ps

Post installation

  1. Open your browser and type in the FQDN or IP address assigned to the server

  2. Send the Hardware ID that you find by going to the NetBeez settings -> License to success@netbeez.net

  3. We will issue you the license, copy/paste it as plain text, and click activate

Did this answer your question?