Setting up a workstation takes three steps:
- Bootstrap – Install Nix, mise, and the
nix/bootstrapprofile (bootstrap.sh) - Deploy – Stow the shared dotfiles and apply the system configuration (
mise run deploy) - Provision – Install host packages and the Nix profile for this machine (
mise run provision:desktop)
This setup requires the dennybaa/dotfiles repository. Install Git and clone the repository:
sudo apt install git -y
# Clone the repository
cd ~ && git clone [email protected]:dennybaa/dotfiles.git
# Alternative: clone via HTTPS
# cd ~ && git clone https://github.com/dennybaa/dotfiles.gitbootstrap.sh installs Nix (if missing), mise into ~/.local/bin, and the
nix/bootstrap profile. It also seeds ~/.config/mise/config.local.toml, which holds
packages for this machine only and is never versioned.
cd ~/dotfiles && ./bootstrap.sh✅ Action required: Before a relogin happens, the Nix bootstrap profile is not sourced. To continue setup in this case, running the command below is required:
. /etc/profile.d/nix.sh
Stows the minimal bundle (shell, editors, the global mise config) and renders the machine config
that cannot be stowed — anything that embeds a secret or a host-specific include — with mise dot apply:
mise run deploy📝 Note: The token comes from gopass (
github/public-api-token) through fnox. When no store is available, mise asks for it once and keeps it in memory for that run — nothing is written to disk:Enter bootstrap secret github_token > ********
github_tokenis the logical name declared in[bootstrap.secrets]; it is read from theGITHUB_USER_TOKEN_PUBLICenvironment variable. Used by Nix and Mise to authenticate GitHub API requests (higher rate limits instead of anonymous access).
With the configuration deployed, install this machine's packages and Nix profile. Two presets are available:
- minimal – a basic set of packages (zsh, tmux, etc.)
- desktop – a full workstation with APT, Flatpak, and Nix packages
mise run provision:minimal
# OR
mise run provision:desktop
# Additionally: browser and file associations
mise run 'setup:desktop:*'
# Desktop applications (happ, sing-box DNS reset) come with the desktop
# bundle; `stow:show` prints what one expands to
mise run stow:show desktop📝 NOTE: Use
--upgrade(or-u) to also upgrade installed packages and flake inputs.
View available mise tasks:
mise tasksPackages are declared in mise config ([bootstrap.packages]), with their repositories in
[bootstrap.apt.sources]:
stow/minimal/mise/.config/mise/config.toml– base packages, on every machinestow/desktop/mise/.config/mise/conf.d/desktop-packages.toml– desktop-only packages~/.config/mise/config.local.toml– packages for this machine only (never versioned)
# what is declared vs what is installed
mise bootstrap packages status
# preview, then install the missing packages (--update also refreshes apt metadata)
mise bootstrap packages apply --dry-run
mise bootstrap packages apply
# upgrade the declared packages that are already installed
mise bootstrap packages upgrade
# add a package to the shared config (the stowed ~/.config/mise/config.toml) and install it
mise bootstrap packages use -g flatpak-user:org.example.App
# machine-local packages go into ~/.config/mise/config.local.toml by hand (never versioned)📝 NOTE:
mise bootstrap packages pruneuninstalls packages no config declares; run it with--dry-runfirst.
provision.toml holds what no registry can carry, one table per task:
| Table | Command | Action |
|---|---|---|
[deb] |
mise run pkg:deb |
fetches each label = url into .cache/debs/ and hands it to apt (bump the URL to upgrade) |
[[skills]] |
mise run pkg:skills |
installs agent skills into ~/.agents/skills/ |
[mime] |
mise run stow desktop |
sets default MIME associations (xdg-mime), runs with the desktop bundle |
All three run as part of provision:desktop.
A single profile approach is recommended: nix/desktop, nix/minimal, etc.
Install a profile:
mise run nix desktopAfter installing the main profile, clean up the bootstrap profile to avoid overlap (recommended, but not necessary):
mise run nix:rm bootstrap📝 Note: Use
-u/--updateto refresh flake versions.