Shell
debian-bootstrap
Bootstrap a new Debian/Ubuntu system with your standard configuration. Portable dotfiles, SSH config, shell setup, and SOPS secrets - no Nix required. Use when setting up a new machine or migrating away from NixOS.
$ Installer
git clone https://github.com/cptfinch/dotfiles ~/.claude/skills/dotfiles// tip: Run this command in your terminal to install the skill
SKILL.md
name: debian-bootstrap description: Bootstrap a new Debian/Ubuntu system with your standard configuration. Portable dotfiles, SSH config, shell setup, and SOPS secrets - no Nix required. Use when setting up a new machine or migrating away from NixOS.
Debian Bootstrap
Recreate your development environment on any Debian/Ubuntu system.
Quick Start
cd ~/.claude/skills/debian-bootstrap
just # See all commands
just setup-all # Full setup (packages + tools + dotfiles + secrets)
First time? See BOOTSTRAP.md for the complete checklist including manual steps (age key, secrets.yaml).
Architecture
┌─────────────────────────────────────────────────────────────────┐
│ debian-bootstrap │
├─────────────────────────────────────────────────────────────────┤
│ apt (packages.txt) │ System packages (git, curl, htop) │
├─────────────────────────────────────────────────────────────────┤
│ mise (mise.toml) │ Everything else: │
│ │ - Languages: node, python │
│ │ - CLI: bat, fd, rg, delta, lazygit │
│ │ - Cloud: gh, hcloud, awscli │
├─────────────────────────────────────────────────────────────────┤
│ uv │ Python package management │
├─────────────────────────────────────────────────────────────────┤
│ SOPS/Age │ Encrypted secrets │
└─────────────────────────────────────────────────────────────────┘
Two bootstrappers, one config file:
misemanages all dev tools viamise.tomluvhandles Python packages (10-100x faster than pip)
What's Included
| Component | Source | Target |
|---|---|---|
| Dev tools | mise.toml | ~/.config/mise/config.toml |
| SSH config | dotfiles/ssh_config | ~/.ssh/config |
| Bash config | dotfiles/bashrc | ~/.bashrc |
| Git config | dotfiles/gitconfig | ~/.gitconfig |
| Starship prompt | dotfiles/starship.toml | ~/.config/starship.toml |
| System packages | packages.txt | via apt |
| SOPS setup | scripts/setup-sops.sh | ~/.config/sops/ |
Commands
# Full setup
just setup-all # Everything in order
# Individual components
just install-packages # apt packages only
just install-extras # mise + uv + all dev tools
just install-dotfiles # All dotfiles
just setup-sops # SOPS/Age encryption
# Secrets & Auth
just decrypt-ssh-keys # Extract SSH keys + add to agent
just setup-gh-auth # Authenticate GitHub CLI
just setup-glab-auth # Authenticate GitLab CLI
# Tool management (after setup)
mise install # Install tools from mise.toml
mise upgrade # Update all tools
mise list # Show installed tools
File Structure
debian-bootstrap/
├── SKILL.md # This file
├── BOOTSTRAP.md # Step-by-step first-time setup guide
├── justfile # All commands
├── mise.toml # Dev tools (the source of truth)
├── packages.txt # apt packages (system only)
├── dotfiles/
│ ├── ssh_config
│ ├── bashrc
│ ├── gitconfig
│ └── starship.toml
└── scripts/
├── install-extras.sh # Installs mise, uv, then mise install
└── setup-sops.sh # SOPS/Age setup
Adding Tools
Edit mise.toml and run mise install:
[tools]
# Languages
node = "lts"
python = "3.12"
go = "latest"
# CLI tools via ubi (GitHub releases)
"ubi:sharkdp/bat" = "latest"
"ubi:jesseduffield/lazygit" = "latest"
Secrets Management
Uses SOPS with Age encryption (same as NixOS setup):
# Decrypt secrets
sops -d ~/.claude/secrets.yaml
# Edit secrets
sops ~/.claude/secrets.yaml
# Extract single secret
sops -d --extract '["github_token"]' ~/.claude/secrets.yaml
Migration from NixOS
This skill was generated from your NixOS/Home Manager config. All Nix-specific paths have been converted to standard locations.
