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.
| Type | submodule |
| Default | |
| Declared in | modules/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:
Is not supported, because /home/user is owned by user.
| Type | absolute path |
| Default | |
| Example | |
| Declared in | modules/options.nix |
nixflix.enable¶
Whether to enable Nixflix.
| Type | boolean |
| Default | |
| Example | |
| Declared in | modules/options.nix |
nixflix.globals¶
Global values to be used by nixflix services
| Type | attribute set |
| Default | |
| Declared in | modules/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:
Is not supported, because /home/user is owned by user.
| Type | absolute path |
| Default | |
| Example | |
| Declared in | modules/options.nix |
nixflix.mediaUsers¶
Extra users to add to the media group.
| Type | list of string |
| Default | |
| Example | |
| Declared in | modules/options.nix |
nixflix.navidrome¶
This option has no description.
| Type | open submodule of attribute set of anything |
| Declared in | modules/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.
| Type | submodule |
| Default | |
| Declared in | modules/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.
| Type | list of string |
| Default | |
| Example | |
| Declared in | modules/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:
Is not supported, because /home/user is owned by user.
| Type | absolute path |
| Default | |
| Example | |
| Declared in | modules/options.nix |