Initial NixOS config

2025-11-19 08:42:21 +01:00
commit 61adc10c49
14 changed files with 1645 additions and 0 deletions
--- a/SETUP.md
+++ b/SETUP.md
@@ -0,0 +1,149 @@
+# Quick Setup Guide
+
+## Initial Setup on Fresh NixOS Installation
+
+### Method 1: One-Line Bootstrap (Recommended)
+
+```bash
+nix-shell -p git --run "bash <(curl -s https://git.cribdev.com/raw/YOUR-USERNAME/nixos-config/main/bootstrap.sh)"
+```
+
+Replace `YOUR-USERNAME` with your actual git username.
+
+### Method 2: Manual Setup
+
+1. **Install git temporarily:**
+   ```bash
+   nix-shell -p git
+   ```
+
+2. **Clone your configuration:**
+   ```bash
+   git clone https://git.cribdev.com/YOUR-USERNAME/nixos-config ~/.config/nixos
+   cd ~/.config/nixos
+   ```
+
+3. **Copy hardware configuration:**
+   ```bash
+   sudo cp /etc/nixos/hardware-configuration.nix ~/.config/nixos/
+   ```
+
+4. **Edit configuration files:**
+   - Open `flake.nix` and replace:
+     - `myhost` with your hostname
+     - `yourusername` with your username
+   
+   - Open `configuration.nix` and set:
+     - `networking.hostName`
+     - `time.timeZone`
+     - User account details
+   
+   - Open `home/home.nix` and set:
+     - Git username and email
+     - Any other personal preferences
+
+5. **Build and apply:**
+   ```bash
+   sudo nixos-rebuild switch --flake ~/.config/nixos#YOURHOSTNAME
+   ```
+
+6. **Reboot:**
+   ```bash
+   reboot
+   ```
+
+## Post-Installation
+
+### Add a Wallpaper
+```bash
+mkdir -p ~/wallpapers
+# Copy your wallpaper to ~/wallpapers/default.jpg
+```
+
+### Test Hyprland
+After reboot, you should be greeted with a login manager. Log in and Hyprland should start automatically.
+
+### Useful First Commands
+```bash
+# Open terminal: SUPER + Return
+# Open app launcher: SUPER + D
+# Open file manager: SUPER + E
+```
+
+## Pushing to Your Git Server
+
+### First Time Setup
+
+1. **Initialize git (if not already done):**
+   ```bash
+   cd ~/.config/nixos
+   git init
+   git add .
+   git commit -m "Initial NixOS configuration"
+   ```
+
+2. **Add your remote:**
+   ```bash
+   git remote add origin https://git.cribdev.com/YOUR-USERNAME/nixos-config.git
+   ```
+
+3. **Push to your server:**
+   ```bash
+   git push -u origin main
+   ```
+
+### Updating Your Configuration
+
+After making changes:
+
+```bash
+cd ~/.config/nixos
+git add .
+git commit -m "Description of changes"
+git push
+```
+
+## Troubleshooting
+
+### "Hardware configuration not found"
+Generate it with:
+```bash
+sudo nixos-generate-config --show-hardware-config > ~/.config/nixos/hardware-configuration.nix
+```
+
+### "Flake inputs need to be updated"
+```bash
+cd ~/.config/nixos
+nix flake update
+sudo nixos-rebuild switch --flake .#YOURHOSTNAME
+```
+
+### Hyprland doesn't start
+Check logs:
+```bash
+journalctl -xe
+cat /tmp/hypr/*/hyprland.log
+```
+
+## What You Get
+
+✅ Full Wayland desktop with Hyprland
+✅ Beautiful animations and effects
+✅ Waybar status bar
+✅ Wofi application launcher
+✅ Dunst notifications
+✅ Screenshot tools (grim + slurp)
+✅ Modern terminal (Kitty)
+✅ Essential CLI tools
+✅ Development environment ready
+✅ Fully reproducible system
+
+## Next Steps
+
+- Customize Waybar appearance in `home/waybar.nix`
+- Adjust Hyprland settings in `home/hyprland.nix`
+- Add more packages in `home/home.nix` or `modules/system.nix`
+- Set up your wallpapers
+- Configure your applications
+
+Enjoy your new NixOS + Hyprland setup! 🎉