Install and configure a tracker server

Resilio Tracker is installed automatically with the Management Console. If you need the tracker service to run on a different host or network, you can deploy a standalone Resilio Tracker instance.

Prerequisites

Before installing Resilio Tracker, make sure that:

The port you plan to use for the Tracker server (TCP/UDP 3000 by default) is open for incoming connections. If the Tracker server is behind a firewall, make sure that the firewall allows incoming connections to this port. If the Tracker server is behind NAT, make sure that port forwarding is configured for this port. For more details about ports and protocols used by Resilio Active Everywhere, see Ports, Protocols and Port Forwarding.

Tip

When installing Tracker server on Windows, the installer will add the corresponding rules to the Windows Firewall to allow incoming connections on the default Tracker port.

Install Tracker

Windows

To install Resilio Tracker on Windows:

Download, then launch the Resilio Tracker installer.
On the welcome page, click Next.
Choose the destination folder, then click Next.
(Optional) Customize your installation, then click Next.
- Main Application - The core Resilio Tracker service.
- Firewall exception - Rules in Windows Firewall allowing Resilio Tracker to establish network connections.
Note

If you choose not to install Firewall exception, make sure that the firewall on the Tracker server host allows incoming connections to the Tracker port (TCP/UDP 3000 by default). If the Tracker server is behind NAT, make sure that port forwarding is configured for this port.
Click Install to proceed.
Click Finish to close the installer.

Change default Tracker port

By default, the installer will install Resilio Tracker server as a Windows service and start it. If you want to choose a different port:

Open Command Prompt as Administrator.
Unregister Tracker server service:
```
ConnectTracker.exe -sd
```
Register Tracker server as a Windows service with the desired port:
```
ConnectTracker.exe -sr -p 12345
```
where 12345 is the desired port.
Start the service manually.

By default Resilio Tracker listens on all interfaces on IPv4 and IPv6 address range, both UDP and TCP, port 3000.

PS C:\Users> netstat -ano | findstr 3000
TCP    0.0.0.0:3000           0.0.0.0:0              LISTENING       6012
TCP    10.255.0.39:55639      172.16.0.67:3000       SYN_SENT        5980
TCP    [::]:3000              [::]:0                 LISTENING       6012
UDP    0.0.0.0:3000           *:*                                    6012
UDP    [::]:3000              *:*                                    6012
PS C:\Users>

Linux

DEB and RPM packages availability

DEB and RPM Resilio Tracker packages are available for Resilio Active Everywhere 3.8 and newer.

Requirements

Firewall rules allowing incoming connections to the port you plan for your Tracker server (TCP/UDP 3000 by default). If the Tracker server is behind NAT, make sure that port forwarding is configured for this port.
x64 hardware architecture (amd64, x86_64).
A Linux distribution with the systemd init manager.

Note

Even though a legacy init.d script is included in the package, it is not guaranteed to work on every GNU/Linux distribution; therefore, using a distribution with systemd is recommended.

Linux - Tarball

To install Resilio Management Console on Linux from a tarball archive:

Download, then extract the Management Console tarball archive:
```
sudo tar xvf tracker.tar.gz -C /opt
```
Start Tracker server:
```
sudo /opt/resilio_tracker/tracker
```

Change default Tracker port

To force Tracker server to listen on a different port, start it with the -p <port> parameter.

sudo /opt/resilio_tracker/tracker -p 12345

Script execution permissions

If the tracker service fails to start, make sure it has execution permissions. If not, set them with the following command:

sudo chmod +x /opt/resilio_tracker/tracker

By default Tracker listens on all interfaces on IPv4 and IPv6 address range, both UDP and TCP, port 3000

Linux - DEB

To install Resilio Tracker on Linux from a DEB package:

Download the .deb package, then run the following command:

sudo dpkg -i resilio-connect-tracker_<version>_<architecture>.deb

Enable automatic startup of the Resilio Tracker service:
```
sudo systemctl enable resilio-connect-tracker
```

Start the Resilio Tracker service:

sudo systemctl start resilio-connect-tracker

systemd and init.d manager options

Options to manage the service through systemd manager: systemctl start/stop/disable/status

Options to manage the service through init.d manager (not recommended):

sudo /etc/init.d/resilio-connect-tracker start
sudo /etc/init.d/resilio-connect-tracker stop

Running the service as current user

By default the Tracker service runs as rsltracker user. To run the Tracker service as a current user:

Check the serice's status:

systemctl status resilio-connect-tracker

(Conditional) Stop the Tracker service:
```
systemctl stop resilio-connect-tracker
```

Start the Tracker service as current user:

sudo systemctl --user start resilio-connect-tracker

Uninstall Resilio Tracker installed from a DEB package

To uninstall Resilio Tracker installed from a DEB package:

sudo dpkg --purge resilio-connect-tracker

Linux - RPM

To install Resilio Tracker on Linux from an RPM package:

Download the .rpm package, then run the following command:

sudo yum install resilio-connect-tracker-<version>_<architecture>.rpm

Enable automatic startup of the Resilio Tracker service:
```
sudo systemctl enable resilio-connect-tracker
```

Start the Resilio Tracker service:

sudo systemctl start resilio-connect-tracker

systemd and init.d manager options

Options to manage the service through systemd manager: systemctl start/stop/disable/status

Options to manage the service through init.d manager (not recommended):

sudo /etc/init.d/resilio-connect-tracker start
sudo /etc/init.d/resilio-connect-tracker stop

Uninstall Resilio Tracker installed from an RPM package

To uninstall Resilio Tracker installed from an RPM package:

sudo yum remove resilio-tracker

Connect Tracker to the Management Console

Resilio Tracker must be added in the Management Console before it can take on tracker duties for connected Agents.

To add a Resilio Tracker server:

In the Management Console, select Settings > Auxiliary servers.
In the Trackers section, click + ADD TRACKER.
In the Configure tracker window:
1. Enter the IP address and the port number of the tracker server.
  
  Note
  
  This can be local or public IP address, or a DNS hostname. The Port number 3000 is the default tracker service port number.
2. Select Mark tracker as default to include this tracker server in the list of default servers.
3. (Optional) Select Don’t check connection to this tracker if you know the Management Console cannot reach the tracker server (for example, if the Management Console is on a LAN network, behind a firewall, or the tracker's public IP address is for WAN agents connections purpose). Otherwise, the Management Console will report an error.
  
  Note
  
  If you add a tracker server with this option enabled, the tracker will appear on the list without a status icon and with Not available as the Last online status.
4. (Optional) Click Test connection to perform connection test.
5. Click Save.

Use Tracker in the Profile

Starting with Resilio Connect v2.12, notion of a Default tracker server is introduced. The tracker which is installed on the Management Console host is marked as default. This is configurable and any other, manually installed, can be selected as default. It's possible to configure several default trackers. This is the tacker that will be used by the agents by default unless any other is specifically configured in the Agent Profile. It's not possible to delete the last default tracker. If checkbox "Default" is selected in the Agent Profile, the agents will use either of the 'default' trackers in load balancing or high availability mode.