about summary refs log tree commit diff
path: root/README.md
blob: d94996c09ce1759144fd8488fdf507e7740ed9a3 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
About Vuizvui
=============

This contains a [set of NixOS modules/configs][manual] and various other Nix
expressions used by OpenLab and its members.

The name "vuizvui" is of Bavarian origins and means something like "too much"
while on the other side "nix" means nothing. Which fits quite well because this
repository is for everything either too complex or not polished/generic enough
to be pushed into [nixpkgs].

Hydra builds: https://headcounter.org/hydra/jobset/openlab/vuizvui

[nixpkgs]:    https://github.com/NixOS/nixpkgs
[manual]:     https://headcounter.org/hydra/job/openlab/vuizvui/manual/latest/download/1/manual.html

## Installing a machine

To enable a vuizvui configuration, first set the nix channel to the corresponding channel build by the hydra, e.g.

    nix-channel --add https://headcounter.org/hydra/channel/custom/openlab/vuizvui/channels.machines.labnet.labtop vuizvui
    nix-channel --update

You have to use the same channel name as is defined by the option `vuizvui.channelName`, `vuizvui` by default.

Then import the `use` module in your configuration, like this:

```nix
{ pkgs, lib, ...}:
{
  imports = [ (import <vuizvui/machines> {}).labnet.labtop.use ];
}
```

    nixos-rebuild switch

All set.