~/etc - dotfiles, configs, settings

Hippocratic License HL3-CL-ECO-LAW-MIL-SV Please don't upload to GitHub

Usage

This repo is loosely based on the strategy described on the Arch Linux Wiki, although it is not Arch-specific, I also use this on MacOS.

Installation

git clone --config=status.showUntrackedFiles=no --bare ssh://git@codeberg.org/norwd/etc.git ~/etc
git --git-dir="${HOME}/etc/" --work-tree="${HOME}" checkout # re-run with `--force` if necessary
git --git-dir="${HOME}/etc/" --work-tree="${HOME}" submodule update --init --recursive

Note, after installation, the dotfiles alias will be available instead of specifying the --git-dir flag.

dotfiles pull
dotfiles add ~/.config/vim/vimrc
dotfiles commit -m "Update vimrc"
dotfiles push

Troubleshooting

gpg: unsafe permissions on homedir '~/.config/gnupg'

This can happen because git doesn't clone the file permissions, other than the executable bit. To correct the error, set read/write¹ for only the owner:

chown -R "$(whoami)" "$GNUPGHOME"
find "$GNUPGHOME" -type f -exec chmod 600 {} \;
find "$GNUPGHOME" -type d -exec chmod 700 {} \;

Using non-zsh shells

While everything in this repo assumes that zsh will be the only shell used, other shells should work with minimal setup.

Just add the following to the end of ~/.profile or ~/.bash_profile:

. ~/.config/profile

Dependencies

Required

Although designed to work out of the box on a freshly installed OS, these dotfiles do require at least git and zsh to be installed. On most POSIX systems, vim should already be installed² , either as vim or sometimes as vi.

Optional

In addition to the required dependencies, there are some other tools that these dotfiles make use of or configure. None of these are essential, but all are highly recommended. Unlike other dotfile repos, these are not automatically installed. This is because not all tools will be used on all installations, there's no need to bring across all the development tools onto a media machine, similarly, there's no need to install media tools onto a development machine. Any of the repos in these lists can be mixed and matched with these dotfiles.

The majority of these have not yet given up GitHub³ , so I maintain Codeberg mirrors⁴ of repositories that I frequently use.