Skip to content

Install / Setup

Configuration can be provided via config file or environment variables, check here for details. A configuration file template can be found here

A Docker image is built with every release. Those images can be found here.

Each image is assigned a version tag upon release. Using the latest tag is recommended & will ensure you pull down the most recent version of the app. If needed, prior releases can be used by specifying the individual release tag, like v0.3.0. Additionally, there is an image built regularly from the latest development branch, which is tagged as dev. While the dev image may contain the latest fixes & features, it is not recommended for most users and may be unstable.

The app can be run as a container with the bundled docker-compose.yml file:

version: "3.0"
services:
  frigate-notify:
    image: ghcr.io/0x2142/frigate-notify:latest
    environment:
      - TZ=Etc/UTC
    volumes:
      - /path/to/config.yml:/app/config.yml
    restart: unless-stopped

Update volumes in the compose file to the location of the config.yml file. By default the app will check the /app/config directory for this file.

The file name & path can also be modified by specifying a path via the FN_CONFIGFILE environment variable:

version: "3.0"
services:
  frigate-notify:
    image: ghcr.io/0x2142/frigate-notify:latest
    environment:
      FN_CONFIGFILE: /app/config/config.yml
      TZ: Etc/UTC
    volumes:
      - /path/to/config_directory:/app/config
    restart: unless-stopped

Optionally, you can run without compose:

docker run -v /path/to/config.yml:/app/config.yml ghcr.io/0x2142/frigate-notify:latest

Local

Binary executables are provided with every release.

Download the latest version & run with:

./frigate-notify

By default, the app will look for a config file in the same directory named config.yml.

You can manually specify a config file name or location with the -c flag:

./frigate-notify -c <new-config-file-location>