Mini CCTV NRV

A mini docker stack that allows you to easily record, clean and serve CCTV recordings made over RSTP while using a minimal amount of system resources.

Preamble

This stack records the camera's streams as-is and doens't re-encode or compress it which can cause it to use more disk space.
The highest I've got on my side is around 70 GiB per day for a 4K-ish cam with AAC audio.

It is highly recommended to put the web page behind a secure reverse-proxy that requires authentication for aditional security.

Setup

Since the stack is a bit rough around the edges for simplicity''s sake you will need to setup a couple of things beforehand.

It should only take 2-3 minutes if you already have the RTSP URL on hand however.

Cameras

Each recording container needs to be given a RSTP stream URL and a unique folder into which the recordings will go.

The URL must be given via the NP_CCTV_URL environment variable, and the output folder via a mounted volume that is mounted as /data in the container.

Here is a simple example:

  cctv_recorder_cam1:
    container_name: cctv-recorder-cam1
    build:
      context: .
      dockerfile: Dockerfile_recorder
    environment:
      - TZ=Europe/Brussels
      - "NP_CCTV_URL=rtsp://user:password@address:554/sub-path"
    volumes:
      - ./recordings/cam1:/data
    restart: unless-stopped

This example will use the rtsp://user:password@address:554/sub-path URL and will put its recordings in ./recordings/cam1.

Cleaner

The cleaner script named cleaner.py only requires you to change 1 variable located near the top of the file.

The variable named MAX_FILE_AGE_SECONDS is used to indicate how long recordings should be kept for and is set to 73 hours by default.

It can also be changed as you wish without recreating the stack since the script is "reloaded" on each run.

Web interface

The web interface only requires you to give it the list of all cams' IDs and a friendly name in the $camsInfo variable.

This variable is located at the top of the htdocs/index.php file and should look like this:

$camsInfo = [
	# Format: [camId, camName]
	["cam1", "Cam #1"],
	["cam2", "Cam #2"]
];

The cam's ID refers to a subfolder of ./recordings into which this cam's recordings are found as .mp4 or .mkv files.

Startup

Once you have finished setting up the stack, you can simply run the following command:

docker-compose up --build -d

Screenshots

Home page

Camera's page with blurred preview

License

This software, as well as the Simplette CSS Stylesheet used for the web interface are both licensed under Unlicense.