Fill out readme
This commit is contained in:
parent
d9c5393cff
commit
8f3b17df2b
33
README.md
33
README.md
|
@ -1,3 +1,32 @@
|
|||
# nixos-config
|
||||
# nixfiles
|
||||
|
||||
My NixOS configuration files
|
||||
My NixOS configuration files.
|
||||
|
||||
## Machines
|
||||
|
||||
* `tohru`: Dell Latitude 5300, personal laptop
|
||||
* `yevaud`: Oracle Cloud free AMD VM, hosts a Forgejo instance
|
||||
|
||||
## Usage
|
||||
|
||||
### Building
|
||||
|
||||
To build locally, run `colmena apply-local` as root.
|
||||
|
||||
To build the remote machines, run `colmena apply`. See the [colmena documentation](https://colmena.cli.rs/) for command-line options. Notable options include:
|
||||
* `--on [hostname]`: build a specific machine only
|
||||
* `--reboot`: reboot after building (but note [this bug](https://github.com/zhaofengli/colmena/issues/166) means it may hang even when the reboot completes successfully)
|
||||
|
||||
### Updating
|
||||
|
||||
Run `npins update` to update the dependencies within the currently selected upgrade channels.
|
||||
|
||||
To upgrade to a new major version of a dependency, simply re-add it and the old version will be overwritten, e.g.:
|
||||
|
||||
```sh
|
||||
npins add --name nixpkgs channel nixos-unstable
|
||||
```
|
||||
|
||||
In either case, commit the changes to `npins/sources.json`.
|
||||
|
||||
See the [npins documentation](https://github.com/andir/npins) for more details.
|
Loading…
Reference in a new issue