https://github.com/sreedevk/dot
The Dot Project. My Dotfiles for Everything Under the Sun
https://github.com/sreedevk/dot
arch-linux archlinux dotfiles dotfiles-linux dotfiles-manager linux linux-scripts
Last synced: about 1 month ago
JSON representation
The Dot Project. My Dotfiles for Everything Under the Sun
- Host: GitHub
- URL: https://github.com/sreedevk/dot
- Owner: sreedevk
- License: mit
- Created: 2019-12-22T13:14:01.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2026-04-06T12:27:38.000Z (2 months ago)
- Last Synced: 2026-04-06T14:36:00.569Z (2 months ago)
- Topics: arch-linux, archlinux, dotfiles, dotfiles-linux, dotfiles-manager, linux, linux-scripts
- Language: Nix
- Homepage:
- Size: 46.7 MB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Nix(OS) Configurations
This repository contains configurations for various programs & Nix(OS).
This Nix(OS) section of this repository is located in the `nixos` directory.
## TODO
1. bug: tmux/terminal reads C-i as \
2. notes sync
3. deploying to apollo (nixOS) via colmena causes nixGL to fail to recognize the nvidia driver
4. keyboard layout "UNKNOWN" at login
5. Switch to niri
6. some dependencies that require secrets start before agenix.service has had the chance to run
## Distant Dreams
1. Get rid of the dependency on a static LAN ip address (potentially using DDNS)
2. improvement: migrate to Traefik
3. k3s setup on apollo
4. disko setup on apollo
## Pre Requisites
### Install Home Manager CLI
```bash
nix-channel --add https://github.com/nix-community/home-manager/archive/master.tar.gz home-manager
nix-channel --update
nix-shell '' -A install
```
### Install System Manager CLI
```bash
nix profile add 'github:numtide/system-manager'
```
## Using Docker Compose to Check Configs
```bash
docker compose run --remove-orphans check
```
## File Structure
### nixos/hosts
- The `nixos/hosts` contains the `configuration.nix` files for each of my machines that runs NixOS.
- Each host is assigned a separate folder.
- 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 & hostname ("\@\".
### nixos/hosts/\/users
- The `users` directory under each host in the nixos/hosts directory is the home-manager configuration for a specific user for that host.
- Each user has a `/default.nix` file that's the entrypoint for that user for home-manager.
### nixos/common/hm
- This directory contains all the home-manager modules that are shared by multiple users across multiple hosts
### nixos/common/os
- This directory contains all the nixos modules that are shared by multiple hosts.
### nixos/common/overlays
- This directory contains all the overlays for nixpkgs used by both nixos and home-manager.
### nixos/common/secrets/mappings.nix
- This is the file that maps *.age files inside the `${ROOT}/secrets` directory to variables that are used by various home-manager & nixos modules.
### secrets
- the `secrets` directory contains all the age encrypted files managed by agenix for both home-manager & nixos modules.
### flake.nix
This is the entry point for both the `home-manager` & `NixOS`.
#### Flake Operations
##### Updating Flake.lock
Since we are using a `nixos/flake.lock` file, we need to update the flake inputs using the command below.
```bash
rake nix:flake:update
```
##### Checking Flake Integrity
```bash
# CHECK CURRENT SYSTEM
rake nix:flake:check
# CHECK ALL SYSTEMS
rake nix:flake:check:all
```
#### NixOS Operations
##### Rebuilding & Switching to NixOS Generations
```bash
# USING REMOTE CACHE
rake nix:os:install
# WITHOUT USING REMOTE CACHE
rake nix:os:install:offline
```
#### Home-Manager Operations
##### Rebuilding & Switching to Home-Manager Generations
```bash
# USING REMOTE CACHE
rake nix:home:install
# USING REMOTE CACHE AND BACKUP CONFLICTING FILE OVERWRITES
rake nix:home:install:backup
# WITHOUT USING REMOTE CACHE
rake nix:home:install:offline
# WITHOUT USING REMOTE CACHE AND BACKUP CONFLICTING FILE OVERWRITES
rake nix:home:install:offline:backup
```