Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rasmus-kirk/nixarr
The Media Server Nixos Module
https://github.com/rasmus-kirk/nixarr
jellyfin nixos nixos-module radarr servarr sonarr vpn
Last synced: 2 days ago
JSON representation
The Media Server Nixos Module
- Host: GitHub
- URL: https://github.com/rasmus-kirk/nixarr
- Owner: rasmus-kirk
- License: gpl-3.0
- Created: 2024-02-21T09:34:24.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-01-24T14:03:11.000Z (11 days ago)
- Last Synced: 2025-01-27T19:05:53.219Z (7 days ago)
- Topics: jellyfin, nixos, nixos-module, radarr, servarr, sonarr, vpn
- Language: Nix
- Homepage: https://nixarr.com/
- Size: 2.23 MB
- Stars: 185
- Watchers: 5
- Forks: 16
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
This is a Nixos module that aims to make the installation and management of
a home media server as easy, and pain free, as possible.
If you have problems or feedback, feel free to join [the
discord](https://discord.gg/n9ga99KwWC).
Note that this is still in a somewhat beta state, beware!
- A few known bugs are present
- Options probably won't be changed, but I reserve the right
- Few options are mostly untested
If you do still use it, any feedback would be 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 Dynamic DNS support:** If you use [Njalla](https://njal.la/)
and don't have a static IP, you can use the `nixarr.ddns.njalla.enable`
option to dynamically update a DNS record that points to the dynamic public
IP of your server or your public VPN IP.
- **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;
# WARNING: 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.
## Options
The documentation for the options can be found
[here](https://nixarr.com/options.html)
## The Wiki
If you want to know how to setup DDNS with Njalla, how to manage secrets in
nix or examples, check out the [wiki](https://nixarr.com/wiki/)
## Examples
See the [wiki](https://nixarr.com/wiki).
## Importing this module
To use this module, add it to your flake inputs in your nix flake file,
like shown in this example flake:
```nix {.numberLines}
{
description = "Your nix flake";
inputs = {
nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable";
nixarr.url = "github:rasmus-kirk/nixarr";
};
outputs = {
nixpkgs,
nixarr,
...
}@inputs: {
nixosConfigurations = {
servarr = nixpkgs.lib.nixosSystem {
system = "x86_64-linux";
modules = [
./nixos/servarr/configuration.nix
nixarr.nixosModules.default
];
specialArgs = { inherit inputs; };
};
};
};
}
```
## VPN Providers
Your VPN-provider should at the very least support wg-quick configurations,
this module does not, and will not, support any other setup. Most VPN-providers
should support this ATM.
Secondly, it's recommended that the VPN you're using has support for _static_
port forwarding as this module has no builtin support for dynamic port
forwarding. I suggest [AirVpn](https://airvpn.org/), since they support
static port forwarding, support wg-quick configurations and accept Monero,
but you can use whatever you want.
> **Notice:** There is [an open](https://github.com/rasmus-kirk/nixarr/issues/27)
> issue regarding the DNS servers of AirVPN.
## Domain Registrars
If you need a domain registrar I suggest [Njalla](https://njal.la/),
they are privacy-oriented, support DDNS and accept Monero. Note that you
don't technically "own" the domain for privacy reasons, they "lease" it to
you. However, this also means that you don't have to give _any_ personal data.
## Thanks
A big thanks to [Maroka-chan](https://github.com/Maroka-chan) for the heavy
lifting on the [VPN-submodule](https://github.com/Maroka-chan/VPN-Confinement),
that was integral to making this project possible.
I would also like to thank [Lasse](https://github.com/lassebomh) for helping
out with the website.