This repository contains configurations for various programs & Nix(OS).

This Nix(OS) section of this repository is located in the nixos directory. The structure & layout of this directory is as follows.

• The nixos/hosts contains the configuration.nix files for each of my computers that runs NixOS.
• Each host is assigned a separate folder.
• The configuration that flake.nix uses is decided by the hostname of the system.
• The creation of users is managed by the configuration.nix but all the user related configuration is handled by home-manager. The common link between the created user and configured user is just the username. This means that users with the same name on all systems will be configured the same way if home-manager is used configure the user.

• The nixos/users directory is the home-manager section of the configuration.
• Each username has a username.nix file that contains user level home-manager managed configurations.
• The nixos/users/shared directory contains modules that are shared across multiple users.

• This directory contains a secrets.json file (encrypted using git crypt). which should contain a JSON object.
• This JSON object is made available to both the home-manager user configurations in nixos/users & system configurations in nixos/hosts via the secrets function parameter.
• Here's the format of secrets.json

```json
{
  "system": {
    "password": "xxx"
  },
  "jira": {
    "token": "xxx"
  },
  "freshrss": {
    "password": "XXX"
  },
  "cargo": {
    "token": "XXX"
  },
  "digital_ocean": {
    "token": "XXX"
  },
  "restic": {
    "password": "XXX"
  },
  "openweather": {
    "token": "XXX"
  },
  "pastebin": {
    "token": "XXX"
  },
  "spotify": {
    "client_id": "XXX",
    "client_secret": "XXX",
    "password": "XXX"
  },
  "wallhaven": {
    "token": "XXX"
  },
  "plex": {
    "claim": "XXX"
  },
  "photoprism": {
    "password": "XXX"
  },
  "mullvad": {
    "account": "XXX",
    "location": "XXX"
  },
  "firefly": {
    "db": {
      "password": "XXX"
    },
    "app": {
      "site_owner": "XXX",
      "secret": "XXX"
    }
  },
  "livebook": {
    "password": "XXX"
  },
  "icecast": {
    "password": "XXX"
  },
  "farfalle": {
    "tavily_api_key": "XXX"
  },
  "taskwarrior": {
    "client_id": "XXX",
    "encryption_secret": "XXX"
  }
}
```

{ config, lib, pkgs, secrets, ... }:
{}

This is the entrypoint for both the home-manager & NixOS.

After making any changes in the nixos/hosts directory, you can install the changes to the current host configuration into NixOS using the following command on the host.

# TO BE RUN FROM THE ROOT OF THIS CLONED REPSITORY
sudo nixos-rebuild switch --flake "./nixos"

# OR 

sudo nixos-rebuild switch --flake "./nixos#<NAME OF THE HOST HERE>"

Since we are using a nixos/flake.lock file, we need to update the flake using the command below and rebuild the system as normal.

# TO BE RUN FROM THE ROOT OF THIS CLONED REPSITORY
nix flake update './nixos'

Any modifications to the nixos/users directory can be installed using this home-manager command

home-manager switch --flake './nixos'

# OR 
home-manager switch --flake './nixos#<NAME OF THE USER HERE>'

Since we are using a nixos/flake.lock file, we need to update the flake using the command below and rebuild using home-manager.

# TO BE RUN FROM THE ROOT OF THIS CLONED REPSITORY
nix flake update './nixos'

-- TODO:

-- TODO:

-- TODO:

-- TODO:

-- TODO: