This repository contains my complete, cross-platform Nix configuration for macOS (via nix-darwin) and other Linux
distributions (via home-manager). It uses Nix Flakes to manage configurations from a single source of truth.
The installation and update processes are automated. Simply run ./bin/install.sh for initial setup or reinstallation.
You can simply run the one-line command for it to clone this repo and perform all initial setup operations.
One Line Installation
bash -c "$(curl -fsSL https://raw.githubusercontent.com/Jackman3005/jacks-nix/latest/bin/install.sh)"To pull the latest changes and apply the nix flake, use the update alias.
Use the upgrade alias to run nix flake update and subsequently attempt to update all packages in the nix flake.
If there are changes and git repo authorization is available, it will commit and push the updates.
Note: An auto-updater runs regularly on GH to check for any updates and publish them to the repo.
.
├── flake.nix # Main Nix flake entrypoint
├── bin/ # Scripts and executables
│ ├── install.sh # Universal installation script
├── hosts/ # Host-specific configurations
│ ├── mac-arm64/
│ └── linux-x64/
├── nix-modules/ # Shared, modular Home Manager configuration
│ ├── default.nix # Assembles all modules
│ ├── git.nix
│ ├── homebrew.nix
│ ├── nvim.nix
│ ├── updates.nix
│ └── shell.nix
├── config/ # Where configuration options and defaults are specified
│ ├── default.nix
│ └── options.nix
├── local/ # Ignored by git. Local machine-specific files.
│ └── last-update-check-timestamp.txt # Helper that keeps track of last update check to avoid checking too often. Safe to delete.
└── assets/ # Extra files/folders to be symlinked or copied.
└── nvim/ # Lazy NeoVIM configuration files.
You can customize the configuration using environment variables. See config/default.nix for the definitive list of env var overrides.
All configuration options can be overridden using environment variables with the JACKS_NIX_ prefix:
| Name | Default | Description |
|---|---|---|
JACKS_NIX_USERNAME |
"jack" | Your system username |
JACKS_NIX_GIT_NAME |
"Jack Coy" | Your full name for Git configuration |
JACKS_NIX_GIT_EMAIL |
"jackman3000@gmail.com" | Your email address for Git configuration |
JACKS_NIX_GIT_SIGNING_KEY |
"ssh-ed25519 ..." | Your public signing key for git. Leave empty to disable. |
JACKS_NIX_ZSH_THEME |
"ys" | Oh My Zsh theme to use |
JACKS_NIX_ENABLE_GIT |
true | Enable Git configuration |
JACKS_NIX_ENABLE_ZSH |
true | Enable Zsh and Oh My Zsh |
JACKS_NIX_ENABLE_NVIM |
true | Enable Neovim configuration |
JACKS_NIX_ENABLE_HOMEBREW |
true (macOS only) | Enable Homebrew (macOS only, true/false) |
JACKS_NIX_ENABLE_PYTHON |
false | Enable Python development tools |
JACKS_NIX_ENABLE_NODE |
false | Enable Node.js development tools |
JACKS_NIX_ENABLE_JAVA |
false | Enable Java development tools |
JACKS_NIX_ENABLE_RUBY |
false | Enable Ruby development tools |
JACKS_NIX_ENABLE_BUN |
false | Enable Bun JavaScript runtime |
JACKS_NIX_ENABLE_ASDF |
false | Enable ASDF version manager |
JACKS_NIX_CONFIG_REPO_PATH |
"$HOME/.config/jacks-nix" | Path where this repository is stored |
JACKS_NIX_MAC_NIXBLD_USER_ID |
350 | Override for nix-darwin nixbld UID |
JACKS_NIX_MAC_NIXBLD_GROUP_ID |
350 | Override for nix-darwin nixbld GID |
export JACKS_NIX_USERNAME="your-username"
export JACKS_NIX_GIT_NAME="Your Name"
export JACKS_NIX_GIT_EMAIL="your.email@example.com"
export JACKS_NIX_ZSH_THEME="robbyrussell"
export JACKS_NIX_ENABLE_PYTHON="true"
export JACKS_NIX_ENABLE_BUN="true"This setup is built around a modular core in nix-modules/ and config/.
config/: Defines default configuration values and reads environment variable overrides.nix-modules/: Each file manages a specific piece of software (Git, Zsh, etc.), pulling values from your central config.hosts/: Contains minimal files that add OS-specific packages or settings.flake.nix: Assembles the correct configuration based on the target OS (darwinConfigurationsfor macOS,homeConfigurationsfor Linux).