1. Top
  2. system
  3. Files
  4. README.md
system

Nix (home-manager) configurations for my computers

  1. 1
  2. 2
  3. 3
  4. 4
  5. 5
  6. 6
  7. 7
  8. 8
  9. 9
  10. 10
  11. 11
  12. 12
  13. 13
  14. 14
  15. 15
  16. 16
  17. 17
  18. 18
  19. 19
  20. 20
  21. 21
  22. 22
  23. 23
  24. 24
  25. 25
  26. 26
  27. 27
  28. 28
  29. 29
  30. 30
  31. 31
  32. 32
  33. 33
  34. 34
  35. 35
  36. 36
  37. 37
  38. 38
  39. 39
  40. 40
  41. 41
  42. 42
  43. 43
  44. 44
  45. 45
  46. 46
  47. 47
  48. 48
  49. 49
  50. 50
  51. 51
  52. 52
  53. 53
  54. 54
  55. 55
  56. 56
  57. 57
  58. 58
  59. 59
  60. 60
  61. 61
  62. 62
  63. 63
  64. 64
  65. 65
  66. 66
  67. 67
  68. 68
  69. 69
  70. 70
  71. 71
  72. 72
  73. 73
  74. 74
  75. 75
  76. 76
  77. 77
  78. 78
  79. 79
  80. 80
  81. 81
  82. 82
  83. 83
  84. 84
  85. 85
  86. 86
  87. 87
  88. 88
  89. 89
  90. 90
  91. 91
  92. 92
  93. 93
  94. 94
  95. 95
  96. 96
  97. 97
  98. 98
  99. 99
  100. 100
  101. 101
  102. 102
  103. 103
  104. 104
  105. 105
  106. 106 
<!--
Copyright 2023 Shota FUJI <pockawoooh@gmail.com>

Permission to use, copy, modify, and/or distribute this software for any
purpose with or without fee is hereby granted.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
PERFORMANCE OF THIS SOFTWARE.

SPDX-License-Identifier: 0BSD
-->

# pocka/system

Home Manager and NixOS configurations for my machines.

## Home Manager configurations

Every file under `modules/hm` is Home Manager module.

A configuration imports a profile module inside `modules/hm/profiles`, which imports other modules.
A root of an import graph should be a profile module.

### Apply with Home Manager installed

To apply configuration, go to repository root and run the below command on system with Nix Flakes enabled and Home Manager installed.
Replace `$NAME` with configuration name (an attribute name in `homeConfigurations` attrset.)

```sh
home-manager switch --flake .#$NAME
```

As the most profiles installs `home-manager` CLI, this will be the most frequently used command after the initial setup.

### Apply using `nix-shell`

To apply configuration without `home-manager` CLI, go to repository root and run the below command on Nix installed system.
Replace `$NAME` with configuration name (an attribute name in `homeConfigurations` attrset.)

```sh
nix-shell --run "home-manager switch --flake .#$NAME"
```

This is useful for initial setup.

### Apply without cloning the repository

To apply configuration without cloning repository, run the below command on Nix Flakes enabled system.
Replace `$NAME` with configuration name (an attribute name in `homeConfigurations` attrset.)

```sh
nix run home-manager/master -- switch --flake git+https://codeberg.org/pocka/system#$NAME
```

This is useful for initial setup and for ephemeral environment.

### Display changes between generations

First, find the directory that contains Nix profiles.
For defaults location, see this page: <https://nix.dev/manual/nix/2.18/command-ref/files/profiles>.

Then run the following:

```sh
nix profile diff-closures --profile <profiles directory>/home-manager
```

## NixOS configurations

Every file under `modules/nixos` is NixOS module.

A configuration imports a profile module inside `modules/nixos/profiles`, which imports other modules.
A root of an import graph should be a profile module.

### Create a NixOS Incus system container

To create an Incus system container image, run the following command:

```sh
nix run .#incus-import workerbee
```

this will generate and import `pocka/workerbee/nixos` image.

### Launch VM

Run the following to launch NixOS VM using QEMU.

```sh
nix run .#nixosConfigurations.queenbee.config.system.build.vm -- -device virtio-vga-gl -display gtk,gl=on -enable-kvm -cpu host -m $MEMORY_SIZE
```

You can see a list of options using `--help` option.

## License

This project is compliant with [REUSE specification](https://reuse.software/).
Commentable files have copyright and license header and uncommentable files (e.g. binary, JSON) have an adjacent text file named `<filename>.license`.

- Files under `programs/` are licensed under [Apache-2.0](./LICENSES/Apache-2.0.txt).
- Other files, including Nix config files, are licensed under [Zero-Clause BSD](./LICENSES/0BSD.txt).