Introduction
Your EVVR Container uses sensible defaults, so that by default your container should use a 16GB recording partition, and automatically start recording any attached cameras (without encrypting the recordings).
It is possible to customise the recording behaviour and set a recording encryption password using a configuration file - either using environment variables when creating the container, or within a seed configuration file.
You have multiple options for configuring your container using a config file - including 'burning in these settings using environment variables, or using a seed config file to provide initial settings for your users.
Available Settings
Changing encryption recording's password warning!
If you already have recordings on your recording volume, then creating/changing the recording password will cause those existing recordings to be unreadable.
The encoder will not proceed in this instance to avoid data loss, so it is recommended that you perform the addition of cameras AND set a recording password in the same step in your environment variable/seed file to avoid unencrypted recording starting automatically as soon as you add your first camera.
To customise your recording set up, you can add the following settings to your config file:
Setting | Description |
EV_RECORDINGS_SIZE_GB | Set to an integer that sets a maximum to use on the recording profile in GB.
The default and minimum is 16 (16GB). The maximum is 4000 (4TB).
It is recommended that the recording volume be on a dedicated partition, just for your container's use. If the new value is changed to less than the size of the existing recordings, then the container will error and exit - please check the encoder logs. |
EV_RECORDINGS_MODE | Set to
Selects between the container will always record, or only record when requested to using actions within alarm rules. |
EV_STORAGE_FULL | Set to
Select container behaviour when the storage partition is full. By default containers will delete the oldest recordings to make room for new recordings, but you can tell the container to stop recording entirely once the disk is full. |
EV_RECORDINGS_ENCRYPTION | By default, the video recordings are not encryption by the container.
To enable recording encryption, you should set a password in this setting. The password must be between 5 and 16 characters long. |
Examples
The minimum settings you would normally add to a config file to set the desired size of the recording partition and a recording password:
EV_RECORDINGS_SIZE_GB=20
EV_RECORDINGS_ENCRYPTION=Pword123!
If you have a use case where you want to use alarm rules to start/stop recording, and then stop recording when the recording disk is full, you can all of the following settings:
EV_RECORDINGS_SIZE_GB=20
EV_RECORDINGS_MODE=RecordOnAlarm
EV_STORAGE_FULL=StopRecording
EV_RECORDINGS_ENCRYPTION=password