Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thiagokokada/nix-configs
My Nix{OS} configuration files
https://github.com/thiagokokada/nix-configs
flake home-manager nix nix-flake nixos
Last synced: about 2 months ago
JSON representation
My Nix{OS} configuration files
- Host: GitHub
- URL: https://github.com/thiagokokada/nix-configs
- Owner: thiagokokada
- License: mit
- Created: 2021-02-07T20:14:02.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-04-22T12:33:55.000Z (5 months ago)
- Last Synced: 2024-04-22T13:49:57.621Z (5 months ago)
- Topics: flake, home-manager, nix, nix-flake, nixos
- Language: Nix
- Homepage:
- Size: 2.14 MB
- Stars: 90
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# nix-configs
[](https://github.com/thiagokokada/nix-configs/actions/workflows/build-and-cache.yml)
*My Nix{OS} configuration files*
## Overview
* nix configuration for my laptops, desktops and more
* **nix flake**-powered
* guaranteed to be **reproducible**
## Disclaimer
This config is not based on any previous available Flake-based Nix{OS} config,
instead I choose to develop my own from the available examples and
documentation. Some of the repositories that helped me to build this config:
- https://github.com/bqv/nixrc
- https://github.com/colemickens/nixcfg
- https://github.com/hlissner/dotfiles
- https://github.com/Mic92/dotfiles
- https://github.com/nrdxp/nixflk
Also, some extra resources and documentation about Flakes:
- [Flakes in NixOS Wiki](https://nixos.wiki/wiki/Flakes)
- [Nix Flakes blog posts from
@eldostra](https://www.tweag.io/blog/2020-05-25-flakes/)
- [Nix documentation](https://nixos.org/manual/nix/unstable/)
**Remember**: Flakes is *experimental*, so you shouldn't try this approach
until you have some experience in Nix.
## Dotfiles
This repository also includes my
[`home-manager`](https://github.com/nix-community/home-manager/) configuration.
It is used to configure home in NixOS systems (using `home-manager` as a NixOS
module) but it should also work in standalone mode.
## Installation
### NixOS
After following the instructions in
[manual](https://nixos.org/manual/nixos/stable/#sec-installation) to prepare the
system and partition the disk, run the following process to install:
```console
$ sudo git clone https://github.com/thiagokokada/nix-configs/ /mnt/etc/nixos
$ sudo chown -R 1000:100 /mnt/etc/nixos # optional if you want to edit your config without root
$ nix flake new --template '.#new-host' # if this is a new hardware
$ sudo nixos-install --flake /mnt/etc/nixos#hostname
```
After installing it succesfully and rebooting, you can uncomment everything and
trigger a rebuild.
#### Remote installations
You can also do remote installations by using `--target-host` flag in
`nixos-rebuild` (from any machine that already has NixOS installed):
```console
$ nixos-rebuild switch --flake '.#hostname' --target-host root@hostname --use-substitutes
```
Or if you don't have `root` access via SSH (keep in kind that the user needs to
have `sudo` permissions instead):
```console
$ nixos-rebuild switch --flake '.#hostname' --target-host user@hostname --use-substitutes --use-remote-sudo
```
Another option for a few hosts is to use
[nixos-anywhere](https://github.com/nix-community/nixos-anywhere). This need to
be a host with [disko](https://github.com/nix-community/disko/) configured. In
this case, you can just run:
```
$ nix run github:numtide/nixos-anywhere -- --flake '.#hostname' root@hostname
```
### Home Manager (standalone)
Start by installing Nix:
```console
$ sh <(curl -L https://nixos.org/nix/install) --daemon
```
To build the Home Manager standalone and activate its configuration, run:
```console
$ nix run '.#homeActivations/'
```
## Testing
You can build a VM to test NixOS configurations with safety running the
command below:
```console
$ nix run '.#nixosVMs/'
```
## Explore
You can explore all outputs from this configuration by using:
``` console
$ nix flake show
```