Code Issues 8 Pull requests Projects 3 Releases Wiki Activity Actions

My portable workstation configs, powered by chezmoi and Git

chezmoi dotfiles linux

Python 36.4%
Go Template 35.8%
Shell 16.3%
CSS 8.3%
C 2.8%
Other 0.4%

Find a file

Alex Cochran 4cfe6230da Update: garbanzo.theme		2026年07月03日 02:31:41 -06:00
.moon	add some moon files	2026年04月23日 14:35:52 -06:00
docs	update wiki	2026年05月01日 17:15:04 -06:00
home	Update: garbanzo.theme	2026年07月03日 02:31:41 -06:00
.chezmoiignore	add zsh + move things to home chezmoiroot	2024年07月03日 13:30:31 -06:00
.chezmoiroot	add zsh + move things to home chezmoiroot	2024年07月03日 13:30:31 -06:00
.editorconfig	update editorconfig	2026年05月01日 10:39:31 -06:00
.gitignore	pivot to tokyonight.vim color model for more flexibility	2026年05月01日 14:13:24 -06:00
.gitmodules	fix starship prompt	2026年05月01日 16:59:28 -06:00
LICENSE.md	license: replace w/ markdown copy	2026年04月28日 20:03:43 -06:00
moon.yml	update moon.yml info	2026年05月01日 20:28:48 -06:00
README.md	update badges	2026年04月30日 23:03:46 -06:00

README.md

@bofur/sysconf

GNU/Linux Hyprland Wayland chezmoi

Alex's flagship dotfiles, designed for GNU/Linux systems and managed with chezmoi

These files constitute the portable settings for applications and environments I run on workstations and servers. This configuration is designed for GNU/Linux systems, but many targeted applications are setup identically across platforms.

More Dotfiles

bofur/lite.sysconf: A pared-down fork of this project for servers and lightweight systems
bofur/droid.sysconf: Config designed for Android systems running Termux

Toolchain

chezmoi: Configuration VCS

Similar to Git, chezmoi keeps a working tree of changes to dotfiles between the managed dotfiles repository and the in-use config files in a user's $HOME directory. This separates the working and saved versions and enables a commit-like state capture of files defining the settings of the system and its applications.

Installation

Tip

Installation of this dotfiles project and its dependencies can be automated with the [included Ansible role][href.ansible-role]. If using this, skip to Operations

Install Chezmoi

Ensure chezmoi is installed:

pacman -S chezmoi

Not using pacman? Other options are listed here.

Clone

Clone this project to the default chezmoi directory ~/.local/share/chezmoi with chezmoi init:

chezmoi init https://codeberg.org/bofur/dotfiles

Optionally include the --apply flag on chezmoi update to run chezmoi apply automatically. chezmoi apply overwrites the machine's state (current config files) with the chezmoi project's state (this dotfiles project), evaluating templates and variables as it hydrates each file/folder.

Operations

Add/Remove Files To/From The Tree

Use chezmoi add on any file outside of the $HOME/.local/share/chezmoi to add it to the dotfiles project. chezmoi forget will remove them from the tree.

Overwrite Local Dotfiles From Origin

Pull changes from the repository and apply them locally with chezmoi update and chezmoi apply, or chezmoi update --apply.

Editing Files

Edit files directly in the ~/.local/share/chezmoi directory using any editor, just like any other project. If outside of the chezmoi path, use chezmoi edit to change managed files. This also requires using chezmoi re-add to add that file's local state to the managed dotfiles.