conversions were done using https://github.com/pennae/nix-doc-munge using (probably) rev f34e145 running nix-doc-munge nixos/**/*.nix nix-doc-munge --import nixos/**/*.nix the tool ensures that only changes that could affect the generated manual *but don't* are committed, other changes require manual review and are discarded.
367 lines
14 KiB
Nix
367 lines
14 KiB
Nix
{ config, lib, pkgs, ... }:
|
|
|
|
with lib;
|
|
let
|
|
cfg = config.services.tahoe;
|
|
in
|
|
{
|
|
options.services.tahoe = {
|
|
introducers = mkOption {
|
|
default = {};
|
|
type = with types; attrsOf (submodule {
|
|
options = {
|
|
nickname = mkOption {
|
|
type = types.str;
|
|
description = lib.mdDoc ''
|
|
The nickname of this Tahoe introducer.
|
|
'';
|
|
};
|
|
tub.port = mkOption {
|
|
default = 3458;
|
|
type = types.int;
|
|
description = lib.mdDoc ''
|
|
The port on which the introducer will listen.
|
|
'';
|
|
};
|
|
tub.location = mkOption {
|
|
default = null;
|
|
type = types.nullOr types.str;
|
|
description = lib.mdDoc ''
|
|
The external location that the introducer should listen on.
|
|
|
|
If specified, the port should be included.
|
|
'';
|
|
};
|
|
package = mkOption {
|
|
default = pkgs.tahoelafs;
|
|
defaultText = literalExpression "pkgs.tahoelafs";
|
|
type = types.package;
|
|
description = lib.mdDoc ''
|
|
The package to use for the Tahoe LAFS daemon.
|
|
'';
|
|
};
|
|
};
|
|
});
|
|
description = lib.mdDoc ''
|
|
The Tahoe introducers.
|
|
'';
|
|
};
|
|
nodes = mkOption {
|
|
default = {};
|
|
type = with types; attrsOf (submodule {
|
|
options = {
|
|
nickname = mkOption {
|
|
type = types.str;
|
|
description = lib.mdDoc ''
|
|
The nickname of this Tahoe node.
|
|
'';
|
|
};
|
|
tub.port = mkOption {
|
|
default = 3457;
|
|
type = types.int;
|
|
description = lib.mdDoc ''
|
|
The port on which the tub will listen.
|
|
|
|
This is the correct setting to tweak if you want Tahoe's storage
|
|
system to listen on a different port.
|
|
'';
|
|
};
|
|
tub.location = mkOption {
|
|
default = null;
|
|
type = types.nullOr types.str;
|
|
description = lib.mdDoc ''
|
|
The external location that the node should listen on.
|
|
|
|
This is the setting to tweak if there are multiple interfaces
|
|
and you want to alter which interface Tahoe is advertising.
|
|
|
|
If specified, the port should be included.
|
|
'';
|
|
};
|
|
web.port = mkOption {
|
|
default = 3456;
|
|
type = types.int;
|
|
description = lib.mdDoc ''
|
|
The port on which the Web server will listen.
|
|
|
|
This is the correct setting to tweak if you want Tahoe's WUI to
|
|
listen on a different port.
|
|
'';
|
|
};
|
|
client.introducer = mkOption {
|
|
default = null;
|
|
type = types.nullOr types.str;
|
|
description = lib.mdDoc ''
|
|
The furl for a Tahoe introducer node.
|
|
|
|
Like all furls, keep this safe and don't share it.
|
|
'';
|
|
};
|
|
client.helper = mkOption {
|
|
default = null;
|
|
type = types.nullOr types.str;
|
|
description = lib.mdDoc ''
|
|
The furl for a Tahoe helper node.
|
|
|
|
Like all furls, keep this safe and don't share it.
|
|
'';
|
|
};
|
|
client.shares.needed = mkOption {
|
|
default = 3;
|
|
type = types.int;
|
|
description = lib.mdDoc ''
|
|
The number of shares required to reconstitute a file.
|
|
'';
|
|
};
|
|
client.shares.happy = mkOption {
|
|
default = 7;
|
|
type = types.int;
|
|
description = lib.mdDoc ''
|
|
The number of distinct storage nodes required to store
|
|
a file.
|
|
'';
|
|
};
|
|
client.shares.total = mkOption {
|
|
default = 10;
|
|
type = types.int;
|
|
description = lib.mdDoc ''
|
|
The number of shares required to store a file.
|
|
'';
|
|
};
|
|
storage.enable = mkEnableOption (lib.mdDoc "storage service");
|
|
storage.reservedSpace = mkOption {
|
|
default = "1G";
|
|
type = types.str;
|
|
description = lib.mdDoc ''
|
|
The amount of filesystem space to not use for storage.
|
|
'';
|
|
};
|
|
helper.enable = mkEnableOption (lib.mdDoc "helper service");
|
|
sftpd.enable = mkEnableOption (lib.mdDoc "SFTP service");
|
|
sftpd.port = mkOption {
|
|
default = null;
|
|
type = types.nullOr types.int;
|
|
description = lib.mdDoc ''
|
|
The port on which the SFTP server will listen.
|
|
|
|
This is the correct setting to tweak if you want Tahoe's SFTP
|
|
daemon to listen on a different port.
|
|
'';
|
|
};
|
|
sftpd.hostPublicKeyFile = mkOption {
|
|
default = null;
|
|
type = types.nullOr types.path;
|
|
description = lib.mdDoc ''
|
|
Path to the SSH host public key.
|
|
'';
|
|
};
|
|
sftpd.hostPrivateKeyFile = mkOption {
|
|
default = null;
|
|
type = types.nullOr types.path;
|
|
description = lib.mdDoc ''
|
|
Path to the SSH host private key.
|
|
'';
|
|
};
|
|
sftpd.accounts.file = mkOption {
|
|
default = null;
|
|
type = types.nullOr types.path;
|
|
description = lib.mdDoc ''
|
|
Path to the accounts file.
|
|
'';
|
|
};
|
|
sftpd.accounts.url = mkOption {
|
|
default = null;
|
|
type = types.nullOr types.str;
|
|
description = lib.mdDoc ''
|
|
URL of the accounts server.
|
|
'';
|
|
};
|
|
package = mkOption {
|
|
default = pkgs.tahoelafs;
|
|
defaultText = literalExpression "pkgs.tahoelafs";
|
|
type = types.package;
|
|
description = lib.mdDoc ''
|
|
The package to use for the Tahoe LAFS daemon.
|
|
'';
|
|
};
|
|
};
|
|
});
|
|
description = lib.mdDoc ''
|
|
The Tahoe nodes.
|
|
'';
|
|
};
|
|
};
|
|
config = mkMerge [
|
|
(mkIf (cfg.introducers != {}) {
|
|
environment = {
|
|
etc = flip mapAttrs' cfg.introducers (node: settings:
|
|
nameValuePair "tahoe-lafs/introducer-${node}.cfg" {
|
|
mode = "0444";
|
|
text = ''
|
|
# This configuration is generated by Nix. Edit at your own
|
|
# peril; here be dragons.
|
|
|
|
[node]
|
|
nickname = ${settings.nickname}
|
|
tub.port = ${toString settings.tub.port}
|
|
${optionalString (settings.tub.location != null)
|
|
"tub.location = ${settings.tub.location}"}
|
|
'';
|
|
});
|
|
# Actually require Tahoe, so that we will have it installed.
|
|
systemPackages = flip mapAttrsToList cfg.introducers (node: settings:
|
|
settings.package
|
|
);
|
|
};
|
|
# Open up the firewall.
|
|
# networking.firewall.allowedTCPPorts = flip mapAttrsToList cfg.introducers
|
|
# (node: settings: settings.tub.port);
|
|
systemd.services = flip mapAttrs' cfg.introducers (node: settings:
|
|
let
|
|
pidfile = "/run/tahoe.introducer-${node}.pid";
|
|
# This is a directory, but it has no trailing slash. Tahoe commands
|
|
# get antsy when there's a trailing slash.
|
|
nodedir = "/var/db/tahoe-lafs/introducer-${node}";
|
|
in nameValuePair "tahoe.introducer-${node}" {
|
|
description = "Tahoe LAFS node ${node}";
|
|
wantedBy = [ "multi-user.target" ];
|
|
path = [ settings.package ];
|
|
restartTriggers = [
|
|
config.environment.etc."tahoe-lafs/introducer-${node}.cfg".source ];
|
|
serviceConfig = {
|
|
Type = "simple";
|
|
PIDFile = pidfile;
|
|
# Believe it or not, Tahoe is very brittle about the order of
|
|
# arguments to $(tahoe run). The node directory must come first,
|
|
# and arguments which alter Twisted's behavior come afterwards.
|
|
ExecStart = ''
|
|
${settings.package}/bin/tahoe run ${lib.escapeShellArg nodedir} --pidfile=${lib.escapeShellArg pidfile}
|
|
'';
|
|
};
|
|
preStart = ''
|
|
if [ ! -d ${lib.escapeShellArg nodedir} ]; then
|
|
mkdir -p /var/db/tahoe-lafs
|
|
# See https://github.com/NixOS/nixpkgs/issues/25273
|
|
tahoe create-introducer \
|
|
--hostname="${config.networking.hostName}" \
|
|
${lib.escapeShellArg nodedir}
|
|
fi
|
|
|
|
# Tahoe has created a predefined tahoe.cfg which we must now
|
|
# scribble over.
|
|
# XXX I thought that a symlink would work here, but it doesn't, so
|
|
# we must do this on every prestart. Fixes welcome.
|
|
# rm ${nodedir}/tahoe.cfg
|
|
# ln -s /etc/tahoe-lafs/introducer-${node}.cfg ${nodedir}/tahoe.cfg
|
|
cp /etc/tahoe-lafs/introducer-"${node}".cfg ${lib.escapeShellArg nodedir}/tahoe.cfg
|
|
'';
|
|
});
|
|
users.users = flip mapAttrs' cfg.introducers (node: _:
|
|
nameValuePair "tahoe.introducer-${node}" {
|
|
description = "Tahoe node user for introducer ${node}";
|
|
isSystemUser = true;
|
|
});
|
|
})
|
|
(mkIf (cfg.nodes != {}) {
|
|
environment = {
|
|
etc = flip mapAttrs' cfg.nodes (node: settings:
|
|
nameValuePair "tahoe-lafs/${node}.cfg" {
|
|
mode = "0444";
|
|
text = ''
|
|
# This configuration is generated by Nix. Edit at your own
|
|
# peril; here be dragons.
|
|
|
|
[node]
|
|
nickname = ${settings.nickname}
|
|
tub.port = ${toString settings.tub.port}
|
|
${optionalString (settings.tub.location != null)
|
|
"tub.location = ${settings.tub.location}"}
|
|
# This is a Twisted endpoint. Twisted Web doesn't work on
|
|
# non-TCP. ~ C.
|
|
web.port = tcp:${toString settings.web.port}
|
|
|
|
[client]
|
|
${optionalString (settings.client.introducer != null)
|
|
"introducer.furl = ${settings.client.introducer}"}
|
|
${optionalString (settings.client.helper != null)
|
|
"helper.furl = ${settings.client.helper}"}
|
|
|
|
shares.needed = ${toString settings.client.shares.needed}
|
|
shares.happy = ${toString settings.client.shares.happy}
|
|
shares.total = ${toString settings.client.shares.total}
|
|
|
|
[storage]
|
|
enabled = ${boolToString settings.storage.enable}
|
|
reserved_space = ${settings.storage.reservedSpace}
|
|
|
|
[helper]
|
|
enabled = ${boolToString settings.helper.enable}
|
|
|
|
[sftpd]
|
|
enabled = ${boolToString settings.sftpd.enable}
|
|
${optionalString (settings.sftpd.port != null)
|
|
"port = ${toString settings.sftpd.port}"}
|
|
${optionalString (settings.sftpd.hostPublicKeyFile != null)
|
|
"host_pubkey_file = ${settings.sftpd.hostPublicKeyFile}"}
|
|
${optionalString (settings.sftpd.hostPrivateKeyFile != null)
|
|
"host_privkey_file = ${settings.sftpd.hostPrivateKeyFile}"}
|
|
${optionalString (settings.sftpd.accounts.file != null)
|
|
"accounts.file = ${settings.sftpd.accounts.file}"}
|
|
${optionalString (settings.sftpd.accounts.url != null)
|
|
"accounts.url = ${settings.sftpd.accounts.url}"}
|
|
'';
|
|
});
|
|
# Actually require Tahoe, so that we will have it installed.
|
|
systemPackages = flip mapAttrsToList cfg.nodes (node: settings:
|
|
settings.package
|
|
);
|
|
};
|
|
# Open up the firewall.
|
|
# networking.firewall.allowedTCPPorts = flip mapAttrsToList cfg.nodes
|
|
# (node: settings: settings.tub.port);
|
|
systemd.services = flip mapAttrs' cfg.nodes (node: settings:
|
|
let
|
|
pidfile = "/run/tahoe.${node}.pid";
|
|
# This is a directory, but it has no trailing slash. Tahoe commands
|
|
# get antsy when there's a trailing slash.
|
|
nodedir = "/var/db/tahoe-lafs/${node}";
|
|
in nameValuePair "tahoe.${node}" {
|
|
description = "Tahoe LAFS node ${node}";
|
|
wantedBy = [ "multi-user.target" ];
|
|
path = [ settings.package ];
|
|
restartTriggers = [
|
|
config.environment.etc."tahoe-lafs/${node}.cfg".source ];
|
|
serviceConfig = {
|
|
Type = "simple";
|
|
PIDFile = pidfile;
|
|
# Believe it or not, Tahoe is very brittle about the order of
|
|
# arguments to $(tahoe run). The node directory must come first,
|
|
# and arguments which alter Twisted's behavior come afterwards.
|
|
ExecStart = ''
|
|
${settings.package}/bin/tahoe run ${lib.escapeShellArg nodedir} --pidfile=${lib.escapeShellArg pidfile}
|
|
'';
|
|
};
|
|
preStart = ''
|
|
if [ ! -d ${lib.escapeShellArg nodedir} ]; then
|
|
mkdir -p /var/db/tahoe-lafs
|
|
tahoe create-node --hostname=localhost ${lib.escapeShellArg nodedir}
|
|
fi
|
|
|
|
# Tahoe has created a predefined tahoe.cfg which we must now
|
|
# scribble over.
|
|
# XXX I thought that a symlink would work here, but it doesn't, so
|
|
# we must do this on every prestart. Fixes welcome.
|
|
# rm ${nodedir}/tahoe.cfg
|
|
# ln -s /etc/tahoe-lafs/${lib.escapeShellArg node}.cfg ${nodedir}/tahoe.cfg
|
|
cp /etc/tahoe-lafs/${lib.escapeShellArg node}.cfg ${lib.escapeShellArg nodedir}/tahoe.cfg
|
|
'';
|
|
});
|
|
users.users = flip mapAttrs' cfg.nodes (node: _:
|
|
nameValuePair "tahoe.${node}" {
|
|
description = "Tahoe node user for node ${node}";
|
|
isSystemUser = true;
|
|
});
|
|
})
|
|
];
|
|
}
|