https://github.com/erven2016/flake

My personal NixOS configuration.
https://github.com/erven2016/flake

Last synced: about 2 months ago
JSON representation

My personal NixOS configuration.

• Host: GitHub
• URL: https://github.com/erven2016/flake
• Owner: Erven2016
• Created: 2024-08-17T13:45:31.000Z (5 months ago)
• Default Branch: main
• Last Pushed: 2024-11-24T16:52:17.000Z (about 2 months ago)
• Last Synced: 2024-11-24T17:29:13.632Z (about 2 months ago)
• Language: Nix
• Size: 65.4 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Erven2016's NixOS Configuration

## Usage

### Creating a new host

Making a directory in `root/hosts/` can create a new host, and the name

of directory will be used as the hostname of this host.

And `configuration.nix`, `hardware-configuration.nix` and `metadata.nix` these

three files must be created under the host directory.

- `configuration.nix`: Individual configuration for a host.

- `hardware-configration.nix`: A configuration that describes hardware information of a host.

  Normally, it should not be modified.

- `metadata.nix`: Storing some options about a host. Options are defined

  in `utils/options/metadata.nix`.

```bash

# A host that hostname is `kvm-test` will be created in this example:

# changing current directory to config

cd path/to/config

# Creating the host directory

mkdir hosts/kvm-test

# Creating must-have files

touch hosts/kvm-test/{configuration,metadata}.nix

# Copying hardware-configuration.nix of this host to config

cp path/to/hardware-configuration.nix hosts/kvm-test/hardware-configuration.nix

# Putting your configuration to `configuratiion.nix` and `metadata.nix`

# then don't forget to add your work to git.

git add hosts/kvm-test

# Last run nixos-build, but you need to specify the hostname at first time.

sudo nixos-rebuild switch --flake .#kvm-test --impure --show-trace

```

### Creating a new user

Similar to creating a new host described above, you just need to create a directory (aka username)

in `root/users/`, and the directory includes two main files `default.nix` and `home.nix`.

The `default.nix` will be imported to `config.users.users.` automatically, and

`home.nix` will be imported to `home-manager.users.`. So be carefully to the scope when

you are writing user configuration.

You need adding the user to `hosts//metadata.nix` which the host you want

to apply the user to:

```nix

# hosts//metadata.nix

{

  # emit ...

  users = [ "" ];

}

```