dotfiles

Yet another dotfiles repository. Configuration files you can carry anywhere.

Features

• Manage dotfiles with chezmoi
• Keep OS-specific files explicit (karabiner is only for macOS)
• Keep setup scripts (install/*.sh) as optional package/bootstrap helpers

Supported OS

• macOS (Only Apple Silicon)
• Ubuntu (Only x64)
• WSL (Ubuntu x64)
• Android (Only Termux x64)

Quick Start

Bootstrap a fresh machine with the official chezmoi entrypoint. It installs chezmoi if missing, clones this repository, and applies every dotfile in one command:

sh -c "$(curl -fsLS https://get.chezmoi.io)" -- init --apply ru-461

Reload your shell so the new configuration takes effect:

exec zsh

(Optional) Install development tools and packages via the bootstrap scripts:

bash "$(chezmoi source-path)/install/run.sh" --target auto

That's it. See Daily Operations for editing and updating your dotfiles afterward.

Daily Operations

chezmoi diff
chezmoi apply
chezmoi update

age Encryption Setup

age encryption can be configured when needed, but is not used yet. No encrypted files are tracked yet.

1. Generate an age key pair:

chezmoi age keygen

2. Set your recipient in ~/.config/chezmoi/chezmoi.toml:

[age]
recipient = "age1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Package Setup Scripts

Dotfile deployment is handled by chezmoi. Package and OS provisioning scripts remain under install/*.sh and functions/*.sh. Use install/run.sh as the stable entrypoint.

bash "$(chezmoi source-path)/install/run.sh" --mode check
bash "$(chezmoi source-path)/install/run.sh" --target auto

Run only selected steps when needed:

bash "$(chezmoi source-path)/install/run.sh" --target auto --only zsh,brew,bundle

Notes on OS-specific Files

• .config/karabiner/** is deployed only on macOS.
• On Linux/WSL/Termux, karabiner files are excluded by .chezmoiignore.tmpl.

Try Docker

Try dotfiles in a reproducible Ubuntu container. Build the image from a locally cloned dotfiles repository.

docker build -t dotfiles --force-rm .

Option 1: Reproduce the current local repository (Recommended)

docker run -it --rm -v "$PWD":/workspace/dotfiles dotfiles

After entering the container, run:

chezmoi init --apply --source=/workspace/dotfiles

Option 2: Reproduce from the remote ru-461 repository

docker run -it --rm dotfiles /usr/bin/bash -lc "chezmoi init --apply ru-461 && exec /usr/bin/bash"

Happy Hacking.