conf-tool v0.1.0

conf-tool

Tool to manage the nixOS config

• conf-tool
• Usage
• Commands
• Example content of /etc/nixos/conf-tool.json

Usage

$ npm install -g conf-tool
$ conf COMMAND
running command...
$ conf (-v|--version|version)
conf-tool/0.1.0 linux-x64 node-v12.16.1
$ conf --help [COMMAND]
USAGE
  $ conf COMMAND
...

Commands

• conf help [COMMAND]
• conf init
• conf update

conf help [COMMAND]

display help for conf

USAGE
  $ conf help [COMMAND]

ARGUMENTS
  COMMAND  command to show help for

OPTIONS
  --all  see all commands in CLI

See code: @oclif/plugin-help

conf init

Initializes a new conf-tool configuration

USAGE
  $ conf init

OPTIONS
  -h, --hwScan             Do a hardware-scan with nixos-generate-config afterwards
  -i, --init               Install the OS with nixos-install (requires -h, also todo)
  -r, --root=root          [default: /] Filesystem-root to use
  -s, --seed=seed          Seed config to copy
  -t, --template=template  [default: meros] Template to copy (meros, nixos)

DESCRIPTION
  ...
  test

See code: src/commands/init.js

conf update

Updates as conf-tool configuration

USAGE
  $ conf update

OPTIONS
  -a, --apply    Apply config with nixos-rebuild switch
  -h, --hwScan   Do a hardware-scan with nixos-generate-config afterwards
  -u, --upgrade  nixos-rebuild switch --upgrade flag

DESCRIPTION
  ...
  test

See code: src/commands/update.js

Example content of /etc/nixos/conf-tool.json

{
  "keys": { // will be added as-is (plugin: keys)
    "i18n": {
      ...
    }
  },
  "users": [ // for plugin users
    "username",
    "other-username"
  ],
  "software": [ // for plugin software
    "nixpkgs.pkgName" // will be validated if exists
  ],
  "softwareAllowUnfree": false // for plugin software allow-unfree (sets the config flag for nixos to allow unfree software)
}