jeirmeister/NixOS-PVE-Deployment-Util
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Activity
7 Commits 1 Branch 0 Tags 61 KiB
Shell 80.3%
Nix 19.7%
13eece9d44
Go to file
root 13eece9d44 Updated README and added TODO
2024-12-10 04:21:30 -08:00
nix-config (feat): drastic improvements to automation of LXC configuration with scaffolding in place for automating VM and LXC build downloads 2024-12-10 04:13:10 -08:00
scripts (feat): drastic improvements to automation of LXC configuration with scaffolding in place for automating VM and LXC build downloads 2024-12-10 04:13:10 -08:00
.gitignore (feat): drastic improvements to automation of LXC configuration with scaffolding in place for automating VM and LXC build downloads 2024-12-10 04:13:10 -08:00
.repo-to-text-settings.yaml (feat): drastic improvements to automation of LXC configuration with scaffolding in place for automating VM and LXC build downloads 2024-12-10 04:13:10 -08:00
README.md Updated README and added TODO 2024-12-10 04:21:30 -08:00
setup.sh (feat): drastic improvements to automation of LXC configuration with scaffolding in place for automating VM and LXC build downloads 2024-12-10 04:13:10 -08:00
TODO.md Updated README and added TODO 2024-12-10 04:21:30 -08:00

README.md

NixOS Proxmox LXC Container Configuration

A comprehensive toolkit for managing NixOS containers in Proxmox VE. This repository provides automated configuration and management tools for NixOS LXC containers.

Features

  • Automated container detection and configuration
  • Optimized NixOS settings for LXC containers
  • Automatic system upgrades and maintenance
  • Proper terminal and shell configuration
  • DHCP networking configuration
  • Secure SSH access setup
  • Nix Flakes support
  • Garbage collection and store optimization

Quick Installation

curl -sSf https://git.jeirslab.xyz/jeirmeister/NixOS-PVE-Deployment-Util/raw/branch/main/setup.sh | bash

What It Does

The installation script will:

  1. Install required dependencies (git)
  2. Clone/update the configuration repository
  3. Detect available NixOS containers
  4. Apply optimized configuration settings
  5. Configure proper LXC terminal access
  6. Set up system maintenance tasks

Manual Installation

If you prefer to inspect the code first:

git clone https://git.jeirslab.xyz/jeirmeister/NixOS-PVE-LXC.git
cd NixOS-PVE-LXC
./setup.sh

Directory Structure

.
├── nix-config/          # NixOS configuration files
│   ├── configuration.nix    # Main configuration
│   ├── lxc.nix             # LXC-specific settings
│   ├── network.nix         # Network configuration
│   └── users.nix           # User and SSH settings
└── scripts/            # Utility scripts
    ├── list-lxcs.sh       # Container detection
    ├── mount-nixos-config.sh  # Configuration deployment
    ├── rebuild-nixos.sh      # System rebuild
    └── setup-lxc-terminal.sh  # Terminal setup

Features in Detail

System Optimization

  • Automatic garbage collection
  • Store optimization
  • Weekly system updates
  • Nix Flakes support

Security

  • SSH-based access
  • No root login
  • Wheel group for sudo access
  • Secure default configurations

Networking

  • DHCP configuration
  • IPv6 support
  • Proper network interface setup

Requirements

  • Proxmox VE 7.0 or later
  • NixOS LXC container(s)
  • Root access to Proxmox host

Contributing

Contributions are welcome! Please feel free to submit pull requests or create issues for bugs and feature requests.

Note

Always review scripts before running them with curl. You can inspect all source code at the repository.