1
0
Fork 0
puter/modules/filebrowser.nix

195 lines
5.1 KiB
Nix
Raw Normal View History

2025-05-19 17:43:46 +02:00
{
config,
pkgs,
lib,
utils,
...
}:
let
cfg = config.services.filebrowser;
inherit (lib) types;
format = pkgs.formats.json { };
defaultUser = "filebrowser";
defaultGroup = "filebrowser";
in
{
options = {
services.filebrowser = {
enable = lib.mkEnableOption "FileBrowser";
package = lib.mkPackageOption pkgs "filebrowser" { };
user = lib.mkOption {
type = types.str;
default = defaultUser;
description = ''
The name of the user account under which FileBrowser should run.
'';
};
group = lib.mkOption {
type = types.str;
default = defaultGroup;
description = ''
The name of the user group under which FileBrowser should run.
'';
};
openFirewall = lib.mkOption {
default = false;
description = ''
Whether to automatically open the ports for FileBrowser in the firewall.
'';
type = types.bool;
};
2025-05-19 17:58:10 +02:00
stateDir = lib.mkOption {
default = "/var/lib/filebrowser";
2025-05-19 17:43:46 +02:00
description = ''
2025-05-19 17:58:10 +02:00
The directory where FileBrowser stores its state.
2025-05-19 17:43:46 +02:00
'';
type = types.path;
};
settings = lib.mkOption {
default = { };
description = ''
Settings for FileBrowser.
Refer to <https://filebrowser.org/cli/filebrowser#options> for all supported values.
'';
type = types.submodule {
freeformType = format.type;
options = {
address = lib.mkOption {
default = "localhost";
description = ''
The address to listen on.
'';
type = types.str;
};
port = lib.mkOption {
default = 8080;
description = ''
The port to listen on.
'';
type = types.port;
};
root = lib.mkOption {
2025-05-19 17:58:10 +02:00
default = "${cfg.stateDir}/data";
defaultText = lib.literalExpression ''
"''${config.services.filebrowser.stateDir}/data"
'';
2025-05-19 17:43:46 +02:00
description = ''
2025-05-19 17:58:10 +02:00
The directory where FileBrowser stores files.
2025-05-19 17:43:46 +02:00
'';
type = types.path;
};
database = lib.mkOption {
2025-05-19 17:58:10 +02:00
default = "/var/lib//database.db";
2025-05-19 17:43:46 +02:00
defaultText = lib.literalExpression ''
2025-05-19 17:58:10 +02:00
"''${config.services.filebrowser.stateDir}/database.db"
2025-05-19 17:43:46 +02:00
'';
description = ''
2025-05-19 17:58:10 +02:00
The path to FileBrowser's Bolt database.
2025-05-19 17:43:46 +02:00
'';
type = types.path;
};
cache-dir = lib.mkOption {
2025-05-19 17:58:10 +02:00
default = "${cfg.stateDir}/cache";
defaultText = lib.literalExpression ''
"''${config.services.filebrowser.stateDir}/cache"
'';
2025-05-19 17:43:46 +02:00
description = ''
The directory where FileBrowser stores its cache.
'';
type = types.nullOr types.path;
};
};
};
};
};
};
config = lib.mkIf cfg.enable {
systemd = {
services.filebrowser = {
after = [ "network.target" ];
description = "FileBrowser";
wantedBy = [ "multi-user.target" ];
serviceConfig = {
ExecStart =
let
args = [
(lib.getExe cfg.package)
"--config"
(format.generate "config.json" cfg.settings)
];
in
utils.escapeSystemdExecArgs args;
2025-05-19 17:58:10 +02:00
StateDirectory = cfg.stateDir;
WorkingDirectory = cfg.settings.root;
2025-05-19 17:43:46 +02:00
User = cfg.user;
Group = cfg.group;
NoNewPrivileges = true;
PrivateDevices = true;
ProtectSystem = "full";
ProtectKernelTunables = true;
ProtectKernelModules = true;
ProtectControlGroups = true;
MemoryDenyWriteExecute = true;
LockPersonality = true;
RestrictAddressFamilies = [
"AF_UNIX"
"AF_INET"
"AF_INET6"
];
PrivateTmp = true;
DevicePolicy = "closed";
RestrictNamespaces = true;
RestrictRealtime = true;
RestrictSUIDSGID = true;
};
};
tmpfiles.settings.filebrowser =
lib.genAttrs
(
[
2025-05-19 18:00:22 +02:00
cfg.stateDir
2025-05-19 17:43:46 +02:00
cfg.settings.root
(builtins.dirOf cfg.settings.database)
]
++ (lib.optional (cfg.settings.cache-dir != null) cfg.settings.cache-dir)
)
(_: {
d = {
inherit (cfg) user group;
mode = "0700";
};
});
};
networking.firewall.allowedTCPPorts = lib.mkIf cfg.openFirewall [ cfg.settings.port ];
users = {
users.${cfg.user} = lib.mkIf (cfg.user == defaultUser) {
2025-05-19 18:00:22 +02:00
home = cfg.stateDir;
2025-05-19 17:43:46 +02:00
group = cfg.group;
isSystemUser = true;
};
groups.${cfg.group} = lib.mkIf (cfg.group == defaultGroup) { };
};
};
meta.maintainers = [
lib.maintainers.lukaswrz
];
}