Developer Toolkit on Omarchy: mise, Docker, LazyDocker & Git
Set up a modern dev environment on Omarchy: mise for runtime versions, Docker + LazyDocker TUI, Git + GitHub CLI, and reproducible dotfiles.
Omarchy wants you productive on day zero. Hereโs the blessed path for runtimes, containers, and dotfiles.
mise โ one version manager to rule them
Omarchy uses mise (not asdf/nvm/rbenv separately):
mise list
mise use --global node@22 ruby@3.4 python@3.12
mise use node@20 --path ~/src/legacy-app # per-project
# In any project
mise trust # allow .mise.toml
cat .mise.toml
# [tools]
# node = "22"
# postgres = "16"
Shims are auto-injected via ~/.zshrc helpers โ Neovim LSPs find them automatically.
Docker + LazyDocker
Docker is preconfigured with rootless-friendly defaults:
docker ps
lazydocker # TUI: logs, stats, exec โ addictive
# compose
docker compose up -d --build
Tip: add your user to docker group once: sudo usermod -aG docker $USER โ re-login.
Git & GitHub CLI
git config --global user.name "Your Name"
git config --global user.email "you@example.com"
gh auth login
gh repo clone basecamp/omarchy -- --depth 1
lazygit # Space + g in Neovim also works
Dotfiles โ Seed / Finalize / Resync
Omarchyโs home management:
- Seed โ ships defaults to
~/ - Finalize โ merges your local config on first boot
- Resync โ
omarchy resyncrestores shipped defaults without nuking~/
Track yours:
omarchy dotfiles init # bootstrap yadm-style tracking
omarchy dotfiles diff
omarchy dotfiles resync # pull upstream dotfile updates
Keep private overrides in ~/.config/hypr/hypr.* and ~/.config/nvim/lua/custom/* โ upgrades wonโt overwrite them (layer 3).
Updates โ stay rolling without pain
omarchy update # pacman -Syu + snapshot
omarchy update --dry # preview
# Or manually
sudo pacman -Syu
yay -Syu # AUR
Because Snapper + Limine snapshots exist, rolling updates are low-stress: bad update โ reboot โ snapshot โ report bug.
FAQ
Should I use VS Code? If you want it: omarchy pkg add visual-studio-code-bin. Omarchy wonโt judge. Neovim stays default.
Agenctic dev? Omarchyโs omarchy binary is agent-friendly โ every tweak is a command, perfect to vibe-code: โset theme to everforest, add fzf, capture screenshotโ.
Continue learning: Omarchy CLI deep dive and System snapshots.