updated docs

This commit is contained in:
rasmus-kirk
2024-02-26 18:06:32 +01:00
parent e93b6ca033
commit adb075340b
2 changed files with 34 additions and 29 deletions
+33 -28
View File
@@ -18,6 +18,39 @@ Note that this is still in a somewhat alpha state, beware!
The general format won't change however. If you do still use it, any feedback The general format won't change however. If you do still use it, any feedback
is greatly appreciated. is greatly appreciated.
## Features
- **Run services through a VPN:** You can run any service that this module
supports through a VPN, fx `nixarr.transmission.vpn.enable = true;`
- **Automatic Directories, Users and Permissions:** The module automatically
creates directories and users for your media library. It also sets sane
permissions.
- **State Management:** All services support state management and all state
that they manage is located by default in `/data/.state/nixarr/*`
- **Optional Automatic Port Forwarding:** This module has a UPNP support that
lets services request ports from your router automatically, if you enable it.
To run services through a VPN, you must provide a wg-quick config file,
that is provided by most VPN providers:
```nix {.numberLines}
nixarr.vpn = {
enable = true;
# IMPORTANT: This file must _not_ be in the config git directory
# You can usually get this wireguard file from your VPN provider
wgConf = "/data/.secret/wg.conf";
}
```
It is possible, _but not recommended_, to run the "*Arrs" behind a VPN,
because it can cause rate limiting issues. Generally, you should use VPN on
transmission and maybe jellyfin, depending on your setup.
## Options
The documentation for the options can be found
[here](https://nixarr.rasmuskirk.com/options)
## Importing this module ## Importing this module
To use this module, add it to your flake inputs in your nix flake file: To use this module, add it to your flake inputs in your nix flake file:
@@ -52,34 +85,6 @@ To use this module, add it to your flake inputs in your nix flake file:
} }
``` ```
## Options
The documentation for the options can be found
[here](https://nixarr.rasmuskirk.com/options)
## Features
- **Run services through a VPN:** You can run any service that this module
supports through a VPN, fx `nixarr.transmission.vpn.enable = true;`
- **Automatic Directories, Users and Permissions:** The module automatically
creates directories and users for your media library. It also sets sane
permissions.
- **State Management:** All services support state management and all state
that they manage is located by default in `/data/.state/nixarr/*`
- **Optional Automatic Port Forwarding:** This module has a UPNP module that
lets services request ports from your router automatically, if you enable it.
To run services through a VPN, you must provide a wg-quick config file:
```nix {.numberLines}
nixarr.vpn = {
enable = true;
# IMPORTANT: This file must _not_ be in the config git directory
# You can usually get this wireguard file from your VPN provider
wgConf = "/data/.secret/wg.conf";
}
```
## Examples ## Examples
This example does the following: This example does the following:
+1 -1
View File
@@ -31,7 +31,7 @@ in {
permissions. permissions.
- **State Management:** All services support state management and all state - **State Management:** All services support state management and all state
that they manage is located by default in `/data/.state/nixarr/*` that they manage is located by default in `/data/.state/nixarr/*`
- **Optional Automatic Port Forwarding:** This module has a UPNP module that - **Optional Automatic Port Forwarding:** This module has a UPNP support that
lets services request ports from your router automatically, if you enable it. lets services request ports from your router automatically, if you enable it.
It is possible, _but not recommended_, to run the "*Arrs" behind a VPN, It is possible, _but not recommended_, to run the "*Arrs" behind a VPN,