Nix Configurations

This repository contains Nix configurations for managing development environments on multiple systems: Zeus, Hestia, Athena (MacBook Pro with M2), Ares, Asclepius, Demeter, Hades, Hypnos, and a Raspberry Pi k3s cluster. These configurations are designed to be reproducible and portable, leveraging Nix Flakes to ensure consistency across setups.

Overview

• Zeus: A development-focused machine with a Hyperland frontend, configured for a streamlined and efficient development environment.
• Hestia: A simpler configuration, currently set up to run basic services and host small databases, intended for lightweight and focused tasks.
• Athena: A MacBook Pro configured with Home Manager for a portable and efficient development environment tailored to macOS.
• Ares: Reserved for future use, with potential for various purposes as needed.
• Asclepius: A home server set up at your sister’s home, intended for running Home Assistant, managing storage, and other home automation tasks.
• Demeter: A storage server configured to manage and share large storage resources efficiently.
• Hades: A dedicated GitHub build server, optimized for handling continuous integration and deployment tasks.
• Hypnos: Configured as a kiosk system, primarily used for displaying advertising sites or other static web content.
• Raspberry Pi k3s Cluster: A lightweight Kubernetes cluster built with Raspberry Pis, configured for distributed computing and containerized workloads.

Systems

1. Zeus

• Purpose: Zeus is configured as a development machine with a focus on providing a powerful and efficient environment.
• Features:
  • Hyperland Frontend: A modern and responsive window manager tailored for development.
  • Development Tools: Includes essential tools for coding, compiling, and other development activities.
  • Custom Configurations: Tweaked settings to optimize the development experience on Zeus.

2. Hestia

• Purpose: Hestia serves as a utility machine, designed to run simple services and host small databases.
• Features:
  • Plain Configuration: A minimal setup, focusing on reliability and simplicity.
  • Service Management: Configured to run essential services with minimal overhead.
  • Database Hosting: Set up to handle small, lightweight databases efficiently.

3. Athena

• Purpose: Athena is a MacBook Pro with M2, configured for development on macOS using Home Manager.
• Features:
  • Home Manager Integration: Manages the development environment efficiently with portable configurations.
  • macOS-Specific Tweaks: Optimized settings and tools tailored for macOS.
  • Aarch64 Support: Configured specifically for the ARM-based architecture of the M2 chip.

4. Ares

• Purpose: Reserved for future use.
• Features: Will be configured based on future needs.

5. Asclepius

• Purpose: A home server at your sister's home, designed to manage smart home devices and storage.
• Features:
  • Home Assistant: Configured to run Home Assistant for smart home management.
  • Storage Management: Set up to manage and provide storage services.

6. Demeter

• Purpose: A dedicated storage server.
• Features:
  • File Sharing: Configured to share large storage resources across the network.

7. Hades

• Purpose: A GitHub build server.
• Features:
  • Continuous Integration: Configured to handle CI/CD pipelines efficiently.

8. Hypnos

• Purpose: A kiosk system for displaying advertising sites.
• Features:
  • Kiosk Mode: Optimized for displaying static content in a locked-down environment.

9. Raspberry Pi k3s Cluster

• Purpose: A lightweight Kubernetes cluster built with Raspberry Pis, ideal for learning, experimentation, and running containerized workloads.
• Features:
  • Master Node: rpi-master acts as the control plane for the cluster.
  • Worker Nodes: rpi-worker01, rpi-worker02, and rpi-worker03 serve as the compute resources.
  • Kubernetes: Running k3s, a lightweight Kubernetes distribution, optimized for ARM-based devices.

Structure

• flake.nix: The core file that defines configurations for Zeus, Hestia, Athena, Ares, Asclepius, Demeter, Hades, Hypnos, and the k3s Raspberry Pi cluster. It includes references to system-specific settings and packages.
• hosts/: Directory containing system-specific configurations for all machines and nodes.
• modules/: Directory containing reusable Nix modules, including:
  • bluetooth.nix: Configuration for managing Bluetooth devices.
  • common.nix: Shared settings and configurations used across multiple systems.
  • network.nix: Networking setup and management.
  • nix.nix: Configuration related to the Nix package manager itself.
  • sound.nix: Audio setup and management.
  • terminal.nix: Terminal emulator configurations and tweaks.
  • virtualisation.nix: Settings for virtualization tools and environments.
  • wasm.nix: Configuration for WebAssembly (WASM) development.

TODO

• Overlays Directory: Implement an overlays directory to manage custom Nix overlays for package modifications or extensions.

Getting Started

Prerequisites

Ensure Nix and Flakes support are enabled on your system. Follow the Nix installation guide to set up Nix or NixOS.

Usage

1. Clone the repository:

   git clone https://github.com/gavdaly/nix-config.git
   cd nix-config

2. Apply the Configuration: Use the configuration for your machine:

   sudo nixos-rebuild switch --flake .

3. Rebuild the System: Rebuild your system with the applied configurations:

   sudo nixos-rebuild switch --flake .

4. Customization:

   • Modify the relevant flake.nix to customize each system's setup.
   • Rebuild the system using the commands above to apply your changes.

5. Format the Configuration: Use nixpkgs-fmt to automatically format your Nix files:

   nixpkgs-fmt .

Contributing

If you have suggestions or improvements, feel free to open an issue or submit a pull request. Contributions are welcome!