Skip to content

Core Options

Top-level nixflix configuration options that apply to the entire system.

Available Options

This page documents 10 configuration options.

nixflix.downloadarr

Downloadarr is a service that is responsible for configuring Starr services with download clients. When you enable the service for that client to run, Downloadarr integrates it automatically with each Starr service.

The list is small right now. However, Downloadarr itself supports supports more integrations than Nixflix supports. It just has less magic built in.

Each module is currently only a subset of the options available. You can add more options reqresented in the UI if you know their keys.

Typesubmodule
Default
{ }
Declared inmodules/downloadarr/options.nix

nixflix.downloadsDir

The location of the downloads directory for download clients.

Warning

All parent directories must have execute permissions for everyone.

Warning

Setting this to any path, where the subpath is not owned by root, will fail! For example:

downloadsDir = /home/user/data

Is not supported, because /home/user is owned by user.

Typeabsolute path
Default
"/data/downloads"
Example
"/data/downloads"
Declared inmodules/options.nix

nixflix.enable

Whether to enable Nixflix.

Typeboolean
Default
false
Example
true
Declared inmodules/options.nix

nixflix.globals

Global values to be used by nixflix services

Typeattribute set
Default
{ }
Declared inmodules/globals.nix

nixflix.mediaDir

The location of the media directory for the services.

Warning

All parent directories must have execute permissions for everyone.

Warning

Setting this to any path, where the subpath is not owned by root, will fail! For example:

mediaDir = /home/user/data

Is not supported, because /home/user is owned by user.

Typeabsolute path
Default
"/data/media"
Example
"/data/media"
Declared inmodules/options.nix

nixflix.mediaUsers

Extra users to add to the media group.

Typelist of string
Default
[ ]
Example
[
  "user"
]
Declared inmodules/options.nix

nixflix.navidrome

This option has no description.

Typeopen submodule of attribute set of anything
Declared inmodules/navidrome

nixflix.notif

Notif is a service that is responsible for configuring Starr services with "Connect" notifications. When you enable the service for a target that it applies to, Notif integrates it automatically with each applicable Starr service.

Unlike Downloadarr, not every notification type applies to every Starr service. Each notification type declares a services list controlling which Starr services it gets configured on.

Each module is currently only a subset of the options available. You can add more options represented in the UI if you know their keys, or add an entirely new type via extraNotifications.

Typesubmodule
Default
{ }
Declared inmodules/notif/options.nix

nixflix.serviceDependencies

List of systemd services that nixflix services should wait for before starting. Useful for mounting encrypted drives, starting VPNs, or other prerequisites.

Typelist of string
Default
[ ]
Example
[
  "unlock-raid.service"
  "tailscale.service"
]
Declared inmodules/options.nix

nixflix.stateDir

The location of the state directory for the services.

Warning

All parent directories must have execute permissions for everyone.

Warning

Setting this to any path, where the subpath is not owned by root, will fail! For example:

stateDir = /home/user/data

Is not supported, because /home/user is owned by user.

Typeabsolute path
Default
"/var/lib"
Example
"/data/.state"
Declared inmodules/options.nix