This repository is public primarily as a reference for people putting together their own Nix setup.

It is a personal flake covering:

• macOS machines via nix-darwin
• Linux user environments via home-manager
• Linux system services via system-manager
• NixOS hosts managed through deploy-rs
• A small set of custom packages under pkgs/

• flake.nix: flake entrypoint and outputs
• justfile: day-to-day commands
• darwin/: macOS system configuration
• home-manager/: shared user environment
• system-manager/: Linux system services
• nixos/: NixOS hosts and modules
• pkgs/: custom packages exposed by the flake overlay
• secrets/: secret modules and CI-safe placeholders

This is not intended to be a turnkey setup. It is my actual personal configuration, with private pieces removed or replaced by placeholders.

You can still clone it and inspect or build the public parts:

git clone git@github.com:gaoyifan/nix.git
cd nix

If you want to evaluate or adapt it locally:

just check

just is the main entry point if you want to use the repo directly:

• macOS: runs just darwin
• Linux: runs just home, then just system

If Nix is not installed yet, just will bootstrap it via the Determinate Systems installer.

# Apply the current machine configuration
just

# Apply only the Home Manager profile on Linux
just home

# Apply only the system-manager profile on Linux
just system

# Apply the nix-darwin system on macOS
just darwin

# Format all Nix files
just fmt

# Validate the flake
just check

# Deploy a NixOS target through deploy-rs
just deploy <target>

# Sync the flake and run nixos-rebuild on the target host
just sync-and-rebuild <target>

The flake exposes:

• packages.<system>.*: custom packages from pkgs/default.nix
• devShells.<system>.default: development shell used by CI and local development
• legacyPackages.<system>.homeConfigurations.<username>: standalone Home Manager configs for Linux
• systemConfigs.<system>.default: standalone system-manager configs for Linux
• darwinConfigurations.<hostname>: integrated macOS system configs
• nixosConfigurations.<hostname>: NixOS host configurations

Examples:

# Enter the dev shell
nix develop

# Build a custom package
nix build .#lazyssh

# Build the default darwin system
nix build .#darwinConfigurations.default.system

The main repository is public. Real secrets live in a private submodule:

• secrets/files/: private submodule with real secrets
• secrets/files-example/: tracked placeholders used in CI and public builds

When the private submodule is absent, the public repo automatically falls back to files-example, so CI and external readers can still evaluate and build the flake safely.

See docs/secrets.md for setup, migration, and adding new secrets.

• Treat this repo as a collection of patterns rather than a reusable module set.
• Hostnames, package choices, and layout reflect one real environment, not a generic template.
• The most reusable parts are likely the justfile, the flake structure, the home-manager/ modules, and the shared nixos/common/ modules.

• Run just fmt before committing.
• Run just check before opening a PR.
• Do not commit result/ symlinks or build outputs.