Self-hosted Sputnik server: changing the location for saved recordings

By default, self-hosted Sputnik servers will store recordings triggered through the Core UI on the local Sputnik file system in the /opt/teradek/proton/rec directory. Recordings are kept in sub-directories based on the encoder's serial number.

The following steps allow you to change that location to a different directory or mount point on the system.

Step 1: Use your preferred command-line (nano, vi, etc.) or GUI-based text editor to modify the /etc/proton.toml configuration file; for example, the following command uses the vi editor with a user account that has sudo privileges:

sudo vi /etc/proton.toml

Step 2: Add the following three lines to the top of the proton.toml configuration file: 

[Recording]
Dir = "/opt/teradek/proton/rec"
DeleteAfterUpload = true

Step 3: Specify the new directory for recordings between the double quotes on the Dir = line.

NOTE: you must ensure that the destination directory specified has appropriate write permissions and is accessible to the self-hosted Sputnik server (e.g. automatically mounted at boot, etc.). 

Step 4: (optional) By default, recordings will be deleted from the local Sputnik's file system once they are uploaded to the remote storage system on Core.

If you wish these recordings to be kept on the local Sputnik server, change DeleteAfterUploadir = false.

NOTE: you must manually maintain the file system on your self hosted Linux server and ensure you have sufficient disk space for any local recordings. There is no file management or automatic grooming performed by the recording service to ensure that sufficient disk space is available.

Step 5: Restart the Sputnik process

sudo systemctl restart sputnik.service sputnik-ui.service proton.service