- Add the
.dotsdirectory and the private config directories to the.gitignorefile.
$ printf '%s\n' '.dots' '.config/claude/' '.config/awesome/' '.config/awesome-worktrees/' >> .gitignore.config/claude and .config/awesome are ignored here because each is tracked by a separate private repo — see steps 9 and 10.
- Clone the repo.
# SSH
$ git clone --bare git@github.com:dmitana/dotfiles.git $HOME/.dots
# HTTPS
$ git clone --bare https://github.com/dmitana/dotfiles.git $HOME/.dots- Restart shell or define the alias in the current shell scope.
$ alias dots='/usr/bin/git --git-dir=$HOME/.dots/ --work-tree=$HOME'
# Add fetch line if you want behaviour as with a non-bare repository clone.
$ dots config remote.origin.fetch '+refs/heads/*:refs/remotes/origin/*'- Checkout the actual content from the bare repository to your
$HOME.$HOMEfolder might already have some stock configuration files which would be overwritten by Git (e.g..vimrc,.zshrc, ...).
# Back up the files if you care about them
$ mkdir -p .dots_backup && \
dots checkout 2>&1 | egrep "\s+\." | awk {'print $1'} | \
xargs -I{} mv {} .dots-backup/{}
# Remove them if you don't care
$ dots checkout 2>&1 | egrep "\s+\." | awk {'print $1'} | \
xargs -I{} rm {}
# Checkout the actual content
$ dots checkout- Set the flag
showUntrackedFilestonoon this specific (local) repository.
$ dots config --local status.showUntrackedFiles no-
Install zsh.
-
Install powerline for tmux (based on this answer and doc). Quick install (when fonts are already installed).
# Ach
$ yay -S powerline powerline-fonts
# Ubuntu
$ sudo apt install powerline
# Python
$ pip install --user powerline-status-
Install nvim.
-
Install the private Claude Code configuration. It lives in a separate private repo (
dmitana/dotfiles-claude) because it holds personal preferences and client-specific skills.$CLAUDE_CONFIG_DIRis already set to~/.config/claudeby.config/zsh/.zshrc, so the config lands where Claude Code looks for it.
$ dots-claude-installThe script is idempotent — re-run it any time to pull updates. It handles a fresh machine, a directory where Claude Code has already written state, and an existing clone. If you don't have access to the private repo it prints a warning and exits successfully, so this repo stays usable by anyone.
- Install the private AwesomeWM configuration. It lives in a separate
private repo (
dmitana/dotfiles-awesome) so it can use a normal git workflow (branches, worktrees, hooks) that a bare$HOMErepo cannot offer. Run this before the Optional section — the SDDM step copies wallpapers from~/.config/awesome/theme/wallpapers/.
$ dots-awesome-installSame behaviour as dots-claude-install: idempotent, adopts an existing directory, and soft-fails
without access to the private repo. Runtime dependencies are listed in the repo's README.
The look of picom (blur, shadows, corners, opacity rules,
window types, fading) lives in the AwesomeWM repo as well: .config/picom/picom.conf
keeps only the machine settings (backend, vsync, ...) and includes rice.conf, a symlink to the
AwesomeWM repo's picom/rice.conf. picom refuses to start while that file is missing, so create
the link right after the install:
$ cd ~/.config/awesome && go-task picom:link- Use the predefined configurations for
X server,Udev rulesandSDDM.
# Monitor and X input configuration
$ sudo ln -s ~/etc/xorg/10-monitor.conf /etc/X11/xorg.conf.d/10-monitor.conf
$ sudo ln -s ~/etc/xorg/40-libinput.conf /etc/X11/xorg.conf.d/40-libinput.conf
# Udev rules configuration
$ sudo cp ~/etc/udev/10-ambilight.rules /etc/udev/rules.d/10-ambilight.rules
$ sudo ln -s ~/etc/udev/99-udisks2.rules /etc/udev/rules.d/99-udisks2.rules
$ sudo ln -s ~/etc/tmpfiles/media.conf /etc/tmpfiles.d/media.conf # set mount directory to the /media/$USER instead of /run/media/$USER
# SDDM configuration
$ sudo mkdir /etc/sddm.conf.d
$ sudo cp ~/etc/sddm/general.conf /etc/sddm.conf.d/general.conf
$ sudo ln -s ~/etc/sddm/xorg.conf /etc/sddm.conf.d/xorg.conf
$ sudo ln -s ~/etc/sddm/theme.conf /etc/sddm.conf.d/theme.conf
$ sudo cp ~/.config/awesome/theme/wallpapers/* /usr/share/sddm/themes/Sugar-Candy/Backgrounds # Copy custom wallpapers
$ sudo cp ~/etc/sddm/themes/Sugar-Candy/theme.conf.user /usr/share/sddm/themes/Sugar-Candy/theme.conf.user
$ sudo ln -sf ~/etc/sddm/scripts/Xsetup /usr/share/sddm/scripts/Xsetup