Efficient tools to build your streaming infrastructure

Nimble Streamer Installation Procedure

Watch Nimble Streamer on Amazon EC2 instance video tutorial to have an example of installation and initial setup.

If you want to add pre-configured Nimble Streamer instance to your WMSPanel account, please read this article for details.
It allows automating Nimble Streamer installation and set up process when building large deployments.

Nimble Streamer is available for 64-bit systems only.

Choose your operating system


Install Nimble Streamer for Ubuntu

Sign up

If you'd like to use WMSPanel for controlling Nimble Streamer, you need to have an account prior to installing the server. Just sign up if you still don't have one.


Install Nimble Streamer server

Run the following command for your OS version to add Nimble Streamer repository:

For Ubuntu 14.04 Trusty (including IBM POWER8):

sudo bash -c 'echo -e "deb http://nimblestreamer.com/ubuntu trusty/">> /etc/apt/sources.list'
Copy
For Ubuntu 15.04 Vivid Vervet and 15.10 Wily Werewolf:
sudo bash -c 'echo -e "deb http://us.archive.ubuntu.com/ubuntu/ trusty main restricted\ndeb http://nimblestreamer.com/ubuntu trusty/">> /etc/apt/sources.list'
Copy
For Ubuntu 16.04 Xenial Xerus:
sudo bash -c 'echo -e "deb http://nimblestreamer.com/ubuntu xenial/">> /etc/apt/sources.list'
Copy
For Ubuntu 18.04 Bionic Beaver:
sudo bash -c 'echo -e "deb http://nimblestreamer.com/ubuntu bionic/">> /etc/apt/sources.list'
Copy
For Ubuntu 18.10 Cosmic Cuttlefish and 19.04 Disco Dingo:
sudo bash -c 'echo -e "deb http://archive.ubuntu.com/ubuntu bionic universe\ndeb http://archive.ubuntu.com/ubuntu bionic-updates universe\ndeb http://nimblestreamer.com/ubuntu bionic/">> /etc/apt/sources.list'
Copy
For Ubuntu 20.04 Focal Fossa:
sudo bash -c 'echo -e "deb http://nimblestreamer.com/ubuntu focal/">> /etc/apt/sources.list'
Copy
For Ubuntu 22.04 Jammy Jellyfish:
sudo bash -c 'echo -e "deb http://nimblestreamer.com/ubuntu jammy/" > /etc/apt/sources.list.d/nimble.list'
Copy


Run for Ubuntu 20.04 and earlier:
wget -q -O - http://nimblestreamer.com/gpg.key | sudo apt-key add -
Copy
Run for Ubuntu 22.04:
wget -q -O - http://nimblestreamer.com/gpg.key | sudo tee /etc/apt/trusted.gpg.d/nimble.asc
Copy

Run:
sudo apt-get update
Copy
sudo apt-get install nimble
Copy
If you'd like to install SRT package as well, run:
sudo apt-get install nimble-srt
Copy
If you'd like to use libsrt 1.5, install nimble-srt-1.5 package instead of nimble-srt (which has version 1.4.4).


Register server in WMSPanel

sudo /usr/bin/nimble_regutil
Copy

You will be asked for your WMSPanel login and password sent to you during sign up.

You can automate registration by adding the following parameters: -u for user name and -p for password, e.g.
sudo /usr/bin/nimble_regutil -u [email protected] -p mypassword

Regutil allows setting up specific display name for Nimble instance in WMSPanel via --server-name option.
sudo /usr/bin/nimble_regutil --server-name display_name

Nimble supports using HTTP proxy to access WMSPanel via --proxy option for nimble_regutil.
sudo /usr/bin/nimble_regutil --proxy proxy_url
proxy_url is HTTP proxy URL/address to use to access WMSPanel, e.g. 192.168.0.1:3128 or proxy_user:[email protected]:3128.
That will add required settings to nimble.conf after successful registration in WMSPanel via proxy.

If you have pre-configured Nimble Streamer instance which is not in WMSPanel, you may register this server in the panel and import existing settings using the following command. Read this article for details. Please back up your rules.conf before using this method to avoid accidental damages.
sudo /usr/bin/nimble_regutil -u [email protected] -p mypassword --apply-rules-conf

You may also apply pre-defined rules.conf to some server which already exists in WMSPanel. You run this command, it will erase existing settings and will apply new settings. This article also has details on this.
This option is avialable only for subscribed accounts. Contact out helpdesk to enable it.
sudo /usr/bin/nimble_regutil -u [email protected] -p mypassword --reapply-rules-conf some_rules.conf
Here some_rules.conf is a file with some previously defined settings, it's an optional parameter.


Restart server:

sudo service nimble restart
Copy
Server will be visible in the panel immediately

Install Nimble Streamer for Debian

Sign up

If you'd like to use WMSPanel for controlling Nimble Streamer, you need to have an account prior to installing the server. Just sign up if you still don't have one.


Install Nimble Streamer server

Run the following command for your OS to add Nimble Streamer repository:

For Debian 8 Jessie:

sudo bash -c 'echo -e "deb http://nimblestreamer.com/debian/ jessie/">> /etc/apt/sources.list'
Copy
For Debian 9 Stretch:
sudo bash -c 'echo -e "deb http://nimblestreamer.com/debian/ stretch/">> /etc/apt/sources.list'
Copy
For Debian 10 Buster:
sudo bash -c 'echo -e "deb http://nimblestreamer.com/debian/ buster/">> /etc/apt/sources.list'
Copy
Run:
wget -q -O - http://nimblestreamer.com/gpg.key | apt-key add -
Copy
apt-get update
Copy
apt-get install nimble
Copy
If you'd like to install SRT package as well, run:
apt-get install nimble-srt
Copy


Register server in WMSPanel

/usr/bin/nimble_regutil
Copy

You will be asked for your WMSPanel login and password sent to you during sign up.

You can automate registration by adding the following parameters: -u for user name and -p for password, e.g.
sudo /usr/bin/nimble_regutil -u [email protected] -p mypassword

Regutil allows setting up specific display name for Nimble instance in WMSPanel via --server-name option.
sudo /usr/bin/nimble_regutil --server-name display_name

Nimble supports using HTTP proxy to access WMSPanel via --proxy option for nimble_regutil.
sudo /usr/bin/nimble_regutil --proxy proxy_url
proxy_url is HTTP proxy URL/address to use to access WMSPanel, e.g. 192.168.0.1:3128 or proxy_user:[email protected]:3128.
That will add required settings to nimble.conf after successful registration in WMSPanel via proxy.

If you have pre-configured Nimble Streamer instance which is not in WMSPanel, you may register this server in the panel and import existing settings using the following command. Read this article for details. Please back up your rules.conf before using this method to avoid accidental damages.
sudo /usr/bin/nimble_regutil -u [email protected] -p mypassword --apply-rules-conf

You may also apply pre-defined rules.conf to some server which already exists in WMSPanel. You run this command, it will erase existing settings and will apply new settings. This article also has details on this.
This option is avialable only for subscribed accounts. Contact out helpdesk to enable it.
sudo /usr/bin/nimble_regutil -u [email protected] -p mypassword --reapply-rules-conf some_rules.conf
Here some_rules.conf is a file with some previously defined settings, it's an optional parameter.


Restart server:

service nimble restart
Copy
Server will be visible in the panel immediately

Install Nimble Streamer for CentOS 7

Sign up

If you'd like to use WMSPanel for controlling Nimble Streamer, you need to have an account prior to installing the server. Just sign up if you still don't have one.


Install Nimble Streamer server

Run the following command to add Nimble Streamer repository:

sudo bash -c 'echo -e "[nimble]\nname= Nimble Streamer repository\nbaseurl=http://nimblestreamer.com/centos/7/\$basearch\nenabled=1\ngpgcheck=1\ngpgkey=http://nimblestreamer.com/gpg.key\n" > /etc/yum.repos.d/nimble.repo'
Copy
Run:
sudo yum makecache
Copy
sudo yum install nimble
Copy
The installer will prompt to install a signature key and a package. Just type "y".
Is this ok [y/N]: y
If you'd like to install SRT package as well, run:
sudo yum install nimble-srt
Copy
If you'd like to use libsrt 1.5, install nimble-srt-1.5 package instead of nimble-srt (which has version 1.4.4).


Register server in WMSPanel

sudo /usr/bin/nimble_regutil
Copy

You will be asked for your WMSPanel login and password sent to you during sign up.

You can automate registration by adding the following parameters: -u for user name and -p for password, e.g.
sudo /usr/bin/nimble_regutil -u [email protected] -p mypassword

Regutil allows setting up specific display name for Nimble instance in WMSPanel via --server-name option.
sudo /usr/bin/nimble_regutil --server-name display_name

Nimble supports using HTTP proxy to access WMSPanel via --proxy option for nimble_regutil.
sudo /usr/bin/nimble_regutil --proxy proxy_url
proxy_url is HTTP proxy URL/address to use to access WMSPanel, e.g. 192.168.0.1:3128 or proxy_user:[email protected]:3128.
That will add required settings to nimble.conf after successful registration in WMSPanel via proxy.

If you have pre-configured Nimble Streamer instance which is not in WMSPanel, you may register this server in the panel and import existing settings using the following command. Read this article for details. Please back up your rules.conf before using this method to avoid accidental damages.
sudo /usr/bin/nimble_regutil -u [email protected] -p mypassword --apply-rules-conf

You may also apply pre-defined rules.conf to some server which already exists in WMSPanel. You run this command, it will erase existing settings and will apply new settings. This article also has details on this.
This option is avialable only for subscribed accounts. Contact out helpdesk to enable it.
sudo /usr/bin/nimble_regutil -u [email protected] -p mypassword --reapply-rules-conf some_rules.conf
Here some_rules.conf is a file with some previously defined settings, it's an optional parameter.


Restart server:

sudo service nimble start
Copy
Server will be visible in the panel immediately

Install Nimble Streamer for Red Hat Enterprise Linux 6 / CentOS 6

Sign up

If you'd like to use WMSPanel for controlling Nimble Streamer, you need to have an account prior to installing the server. Just sign up if you still don't have one.


Install Nimble Streamer server

Install RHEL EPEL repository

wget http://dl.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm
Copy
wget http://rpms.famillecollet.com/enterprise/remi-release-6.rpm
Copy
sudo rpm -Uvh remi-release-6*.rpm epel-release-6*.rpm
Copy
Run the following command to add Nimble Streamer repository:
sudo bash -c 'echo -e "[nimble]\nname= Nimble Streamer repository\nbaseurl=http://nimblestreamer.com/centos/6/\$basearch\nenabled=1\ngpgcheck=1\ngpgkey=http://nimblestreamer.com/gpg.key"' > /etc/yum.repos.d/nimble.repo
Copy
Run:
sudo yum makecache
Copy
sudo yum install nimble
Copy
The installer will prompt to install a signature key and a package. Just type "y".
Is this ok [y/N]: y
If you'd like to install SRT package as well, run:
sudo yum install nimble-srt
Copy


Register server in WMSPanel

sudo /usr/bin/nimble_regutil
Copy

You will be asked for your WMSPanel login and password sent to you during sign up.

You can automate registration by adding the following parameters: -u for user name and -p for password, e.g.
sudo /usr/bin/nimble_regutil -u [email protected] -p mypassword

Regutil allows setting up specific display name for Nimble instance in WMSPanel via --server-name option.
sudo /usr/bin/nimble_regutil --server-name display_name

Nimble supports using HTTP proxy to access WMSPanel via --proxy option for nimble_regutil.
sudo /usr/bin/nimble_regutil --proxy proxy_url
proxy_url is HTTP proxy URL/address to use to access WMSPanel, e.g. 192.168.0.1:3128 or proxy_user:[email protected]:3128.
That will add required settings to nimble.conf after successful registration in WMSPanel via proxy.

If you have pre-configured Nimble Streamer instance which is not in WMSPanel, you may register this server in the panel and import existing settings using the following command. Read this article for details. Please back up your rules.conf before using this method to avoid accidental damages.
sudo /usr/bin/nimble_regutil -u [email protected] -p mypassword --apply-rules-conf

You may also apply pre-defined rules.conf to some server which already exists in WMSPanel. You run this command, it will erase existing settings and will apply new settings. This article also has details on this.
This option is avialable only for subscribed accounts. Contact out helpdesk to enable it.
sudo /usr/bin/nimble_regutil -u [email protected] -p mypassword --reapply-rules-conf some_rules.conf
Here some_rules.conf is a file with some previously defined settings, it's an optional parameter.


Restart server:

sudo service nimble start
Copy
Server will be visible in the panel immediately

Install Nimble Streamer for Windows and Windows Core

Sign up

If you'd like to use WMSPanel for controlling Nimble Streamer, you need to have an account prior to installing the server. Just sign up if you still don't have one.


Install Nimble Streamer

Download Nimble Streamer installer
Download Nimble

Launch the installer and follow setup wizard steps.


Register server in WMSPanel

Windows 8.1 / Windows 10:
Search for "Register Nimble Streamer" in the Windows Start menu


Windows 7 / Windows Server 2003/2008/2012/2016:
Start -> All Programs -> Nimble Streamer -> Register Nimble Streamer


Server will appear in the panel immediately.
If you got "Unable to find writable nimble.conf file" message than you need to right-click on "Register Nimble Streamer" and select "Run as Administrator".


Firewall setup (optional)

You may need to add firewall rule for Windows 8:

  • Search for "firewall" in the Windows 8 Start menu.
  • Select Windows Firewall from the options that appear in the top left.
  • Click on "Allow an app or feature through Windows firewall" in the Windows Firewall window.
  • Click "Allow another app..." in the bottom right corner.
  • Click "Browse..." and select C:\Program Files\Nimble Streamer\bin\nimble.exe
  • Click "Add" to add Nimble Streamer to the "Allowed apps" list.


Troubleshooting

You may get message like this:

"The application has failed to start because its side-by-side configuration is incorrect.
Please see the application event log or use the command-line sxstrace.exe tool for more detail.
Press any key to continue . . ."
It means that you need to install the following packages:

Install Nimble Streamer for Mac OS X using Docker

Sign up

If you'd like to use WMSPanel for controlling Nimble Streamer, you need to have an account prior to installing the server. Just sign up if you still don't have one.


Use Docker

Nimble Streamer package is not available for macOS so we provide another approach based on Docker usage.
Install Nimble Streamer with SRT on MacOS using Docker describes the setup process.

Install Nimble Streamer for Raspbian on Raspberry Pi / Orange Pi / Odroid

Sign up

If you'd like to use WMSPanel for controlling Nimble Streamer, you need to have an account prior to installing the server. Just sign up if you still don't have one.


Install Nimble Streamer server

Run the following command to add Nimble Streamer repository:

For Raspbian 9 (Stretch) and Raspbian 10 (Buster) 32-bit (armhf):

sudo bash -c 'echo -e "deb http://nimblestreamer.com/raspbian/ stretch/">> /etc/apt/sources.list'
Copy
For Raspbian 10 (Buster) 64-bit (arm64):
sudo bash -c 'echo -e "deb http://nimblestreamer.com/raspbian/ buster/">> /etc/apt/sources.list'
Copy
For Ubuntu 20.04 (Focal Fossa) 64-bit (arm64):
sudo bash -c 'echo -e "deb http://us-east-2.ec2.ports.ubuntu.com/ubuntu-ports/ bionic universe\ndeb http://nimblestreamer.com/raspbian/ buster/">> /etc/apt/sources.list'
Copy
Run:
wget -q -O - http://nimblestreamer.com/gpg.key | sudo apt-key add -
Copy
sudo apt-get update
Copy
sudo apt-get install nimble
Copy
If you need to install SRT package as well, run:
sudo apt-get install nimble-srt
Copy


Register server in WMSPanel

/usr/bin/nimble_regutil
Copy

You will be asked for your WMSPanel login and password sent to you during sign up.

You can automate registration by adding the following parameters: -u for user name and -p for password, e.g.
sudo /usr/bin/nimble_regutil -u [email protected] -p mypassword

Regutil allows setting up specific display name for Nimble instance in WMSPanel via --server-name option.
sudo /usr/bin/nimble_regutil --server-name display_name

Nimble supports using HTTP proxy to access WMSPanel via --proxy option for nimble_regutil.
sudo /usr/bin/nimble_regutil --proxy proxy_url
proxy_url is HTTP proxy URL/address to use to access WMSPanel, e.g. 192.168.0.1:3128 or proxy_user:[email protected]:3128.
That will add required settings to nimble.conf after successful registration in WMSPanel via proxy.

If you have pre-configured Nimble Streamer instance which is not in WMSPanel, you may register this server in the panel and import existing settings using the following command. Read this article for details. Please back up your rules.conf before using this method to avoid accidental damages.
sudo /usr/bin/nimble_regutil -u [email protected] -p mypassword --apply-rules-conf

You may also apply pre-defined rules.conf to some server which already exists in WMSPanel. You run this command, it will erase existing settings and will apply new settings. This article also has details on this.
This option is avialable only for subscribed accounts. Contact out helpdesk to enable it.
sudo /usr/bin/nimble_regutil -u [email protected] -p mypassword --reapply-rules-conf some_rules.conf
Here some_rules.conf is a file with some previously defined settings, it's an optional parameter.


Restart server:

sudo service nimble restart
Server will be visible in the panel immediately


Set up streaming scenarios

You may now use the following setup instructions to configure your server:

Nimble Streamer config cloud backup allows making manual and automatic backups of Nimble streaming settings and restore them any time in case of misconfiguration.

Zabbix monitoring of Nimble Streamer and SRT streams could be helpful to track server and streams performance.

Secure your account in 3 easy steps article gives ideas about working securely in WMSPanel.

You may find more instructions under respective Live streaming and VOD streaming sections.

You can also check other control and configuration options for Nimble Streamer like config files, APIs, performance tuning, load balancing and more.


What's next?

To operate server run:
sudo service nimble status|start|stop


Upgrading Nimble Streamer

Having Nimble Streamer installed, you may get the latest server version by following easy upgrade procedure for your OS. Make update and get latest available features.
You can read release notes with description of major changes in the product.


Uninstall Nimble Streamer

You can un-install our agent any time by following this un-installation procedure.