Skip to content

Installing Watcher Cluster or Single

Installation main steps

  1. Install Flussonic Watcher on the managing server. Skip the steps marked "For cluster only" if you have just one server. PostgreSQL and Flussonic Media Server are installed automatically together with Watcher. All required steps for setting up these tools are included in the installation instructions.

  2. Create a user with Watcher administrator privileges in the Watcher web UI.

    This would be enough for Watcher Single installation.

    To create a Cluster, proceed with the following steps:

  3. Install Flussonic Media Server on all streaming servers.

  4. Prepare the streamers before adding them to the Watcher settings.

All the steps are described below.

You can also update or roll back Watcher as described in Updating Watcher or rolling back to previous version.

Installing Flussonic Watcher

  1. On the server where you plan to run Watcher execute the command:

    curl -sSf | sh

    After successful installation, the system advises you to start PostgreSQL and suggests the command to do so. Do not start PostgreSQL yet, just go to the next step which is user creation.

  2. Create the user and the database. First, create the user vsaas by typing this command:

    sudo -u postgres -i createuser -P vsaas

    The system will prompt you to enter the password that will be used for the user vsaas:

    Enter password for new role: (come up with and enter Watcher super admin password)


    Both login and password must NOT include any of the following characters: @, ;, #, [, \, /, =, $

    Type the password again for confirmation:

    Enter it again: (re-enter Watcher super admin password)

  3. Create the database vsaas_production with the created user vsaas as the owner:

    sudo -u postgres -i createdb -O vsaas -e -E UTF8 -T template0 vsaas_production

    The system's response if the database was created successfully:

    CREATE DATABASE vsaas_production OWNER vsaas ENCODING 'UTF8' TEMPLATE template0;

  4. Launching the flussonic service: service flussonic start

  5. Open the Flussonic's administrative web UI at http://(Flussonic server address)/admin in your browser. Set the following parameters:

    • Paste the license key and come up with credentials for Flussonic server.

    License and credentials setup


    Both login and password must NOT include any of the following characters: @, ;, #, [, \, /, =, $

    • Go to IP cameras and specify the path to the database in the Database path box.


    Replace VSAAS_PASSWORD with the real password of the vsaas user that you created in previous steps.

    Path to Watcher database

    • For cluster only: Go to Cluster -> Settings and specify cluster_key for local streamer of the Watcher. The cluster key is an arbitrary string that you set for your cluster, it's like the cluster name or code.

Now it's time to create the Watcher main administrator.

Creating the Watcher administrator

To create Watcher super administrator:

  1. Go to http://(Flussonic server address).
  2. Your browser will show a dialog to enter credentials. This step protects your newly installed Watcher from unauthorized third party access. You will not have to enter these credentials when open this page next times.

    Enter Flussonic credentials that you have set up at step 5 when installed Flussonic Watcher.

    Browser authentication at first start

  3. The administrator control panel opens (we also call it the Watcher web UI). On the very first launch, the system will ask you to enter the login and come up with the password to create the first Watcher's administrator account.

Installing Watcher - create the admin

The installation for single-server mode is now complete.

If you want to create a cluster, you will need to prepare streamers and set up Watcher to work as part of a cluster (see next steps).

(For cluster only) Installing Flussonic Media Server on streamers

Flussonic Media Server is installed on all streaming servers.

Run the command:

curl -sSf | sh

Now start Flussonic Media Server:

service flussonic start

Learn more about installation of Flussonic Media Server in the Flussonic documentation:

On each streamer set up HTTPS and specify the cluster key in Flussonic's settings – see Create a cluster below.

(For cluster only) Creating a cluster (multiple server mode)

Creating a cluster means to add streamers (streaming servers) in the settings of Flussonic Watcher. Streamers (streaming servers) are servers intended to stream video from IP cameras. You must add at least one streamer on which IP cameras are added to configuration. This will allow you to start receiving video from cameras in cluster mode.

The Health page in Watcher UI is essential for the cluster configuration.


  1. For each streamer, install Flussonic Media Server on a separate server, which will act as a streamer. In other words, besides the server with Flussonic Watcher, you must have at least one other server with a public IP address and Flussonic Media Server installed.

  2. After you install Flussonic on a streamer, immediately change the administrator's login and password on each streamer.

  3. Configure HTTPS on each streamer. It is enough to set the port for HTTPS, and Flussonic will use self-signed SSL certificates. Open the web interface and specify the port for HTTPS in Config > SSL-tunneled protocols, for example, 443. Other ways to configure HTTPS

  4. Set identical date and time on the managing server and on each streamer. For example, you can use the timedatectl utility for that.

  5. In each streamer settings, specify cluster_key (the key must be the same as the cluster key for Flussonic Watcher).

  6. Configure the DNS zone for the managing server.


For cluster only: For Watcher to work correctly in a cluster, you need to add the A record in the DNS zone settings for your domain, where you specify the host name. This hostname must also be registered in the operating system on the server with Flussonic Watcher (the managing server). This is necessary for streamers to access the managing server.

To check that the hostname resolves, run on the managing server the command hostname — it must return the correct hostname specified in the DNS settings, for example,

Adding streamers to Watcher

When the streaming server is ready for work, you need to add it in the settings of Flussonic Watcher:

  1. Go to Health
  2. Click Create a streamer
  3. Enter the required settings:

    • API URL – the domain name of the streaming server.
    • Cluster key – the cluster key used in the cluster (the cluster_key option in the configuration file) that identifies a streamer belonging to a particular cluster.

These and other settings are described in details on the Status, settings and adding streamers page.