Skip to content

Installing Watcher Cluster or Single


Watcher is installed from the package flussonic-watcher, and Flussonic Media Server and PostgreSQL are automatically installed with Watcher.

See Watcher installation ways for details about Cluster and Single editions.

Installation main steps

To install Watcher:

  1. Install Flussonic Watcher on the managing server. PostgreSQL and Flussonic Media Server are installed automatically together with Watcher.

  2. Specify the path to PostgreSQL in the administrator UI of Flussonic Media Server.

  3. Create a user with Watcher administrator privileges by using the Watcher's administrator UI.

That's all for a single-server Watcher.

If you plan to create a cluster, after you've done steps 1-3 continue the installation with the following steps:

  1. Install Flussonic Media Server on all streaming servers.

  2. Create a cluster and register streamers in Watcher by using the Watcher's administrator UI.

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):80/admin in your browser. Set the following parameters:

  6. Paste the license key and come up with credentials for Flussonic server as described here.

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

  8. For cluster only: Go to Cluster - Settings and specify cluster_key for local streamer of the Watcher.

  9. For cluster only: Add the mode cluster option in the configuration file /etc/flussonic/flussonic.conf:

    vsaas { database postgresql://vsaas:vsaas_password@localhost/vsaas_production; endpoint enabled; mode cluster; }

    After editing the file restart Flussonic Media Server with the command:

    service flussonic restart

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

Creating the Watcher administrator

Go to http://(Flussonic server address):80. 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) 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.

  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.

(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 above.