Command line interface

nicos

nix run github:plmercereau/nicos -- [OPTIONS] COMMAND [ARGS]...

Options

--help	Show this message and exit.

Commands

build	Build a machine ISO image.
create	Create a new machine in the cluster.
deploy	Deploy one or several existing machines
init	Initialise a new cluster.
install	Install a machine using nixos-anywhere.
secrets	Manage the secrets for the cluster

nicos build

nix run github:plmercereau/nicos -- build [OPTIONS] [MACHINE]

Build a machine ISO image.

Options

-k, --private-key-path TEXT	The path to the private key to use. Defaults to ssh_<machine>_ed25519_key.
--help	Show this message and exit.

nicos create

nix run github:plmercereau/nicos -- create [OPTIONS] [NAME]

Create a new machine in the cluster.

Options

--rekey / --no-rekey	Rekey the secrets after creating the machine configuration.
--stage / --no-stage	Stage the changes to git.
--help	Show this message and exit.

nicos deploy

nix run github:plmercereau/nicos -- deploy [OPTIONS] [MACHINES]...

Deploy one or several existing machines

Options

--all	Deploy all available machines.
--remote-build	Build on remote host.
--help	Show this message and exit.

nicos init

nix run github:plmercereau/nicos -- init [OPTIONS]

Initialise a new cluster.

Options

--stage / --no-stage	Stage the changes to git.
--help	Show this message and exit.

nicos install

nix run github:plmercereau/nicos -- install [OPTIONS] [MACHINE] [IP]

Install a machine using nixos-anywhere.

Options

--user TEXT	User that will connect to the machine through nixos-anywhere.
--remote-build	build the closure on the remote machine instead of locally and copy-closuring it.
--help	Show this message and exit.

nicos secrets

nix run github:plmercereau/nicos -- secrets [OPTIONS] COMMAND [ARGS]...

Manage the secrets for the cluster

Options

--help	Show this message and exit.

Commands

edit	Edit a secret
export	Export the secrets config in the cluster as a JSON object
list	List the secrets in the cluster
rekey	Rekey all the secrets in the cluster.
user	Edit a user password
vpn	Add or replace a Wireguard private key of a given host
wifi	Edit wifi networks and passwords

nicos secrets edit

nix run github:plmercereau/nicos -- secrets edit [OPTIONS] PATH

Edit a secret

Options

--stage / --no-stage	Stage the changes to git.
--help	Show this message and exit.

nicos secrets export

nix run github:plmercereau/nicos -- secrets export [OPTIONS]

Export the secrets config in the cluster as a JSON object

Options

--help	Show this message and exit.

nicos secrets list

nix run github:plmercereau/nicos -- secrets list [OPTIONS]

List the secrets in the cluster

Options

--help	Show this message and exit.

nicos secrets rekey

nix run github:plmercereau/nicos -- secrets rekey [OPTIONS]

Rekey all the secrets in the cluster.

Options

--stage / --no-stage	Stage the changes to git.
--help	Show this message and exit.

nicos secrets user

nix run github:plmercereau/nicos -- secrets user [OPTIONS] NAME [PASSWORD]

Edit a user password

Options

--stage / --no-stage	Stage the changes to git.
--force	Force the change without prompt if the secret already exists.
--help	Show this message and exit.

nicos secrets vpn

nix run github:plmercereau/nicos -- secrets vpn [OPTIONS] [NAME]

Add or replace a Wireguard private key of a given host

Options

--stage / --no-stage	Stage the changes to git.
--force	Force the change without prompt if the secret already exists.
--help	Show this message and exit.

nicos secrets wifi

nix run github:plmercereau/nicos -- secrets wifi [OPTIONS]

Edit wifi networks and passwords

Options

--stage / --no-stage	Stage the changes to git.
--help	Show this message and exit.