In the Unix world programs are commonly configured in two different ways, via
command line arguments or text based configuration files. Programs with many
options like window managers or text editors are configured on a per-user basis
with files in your home directory (~
). In unix like operating systems any
file or directory name that starts with a period or full stop character (.
)
is considered hidden, and in a default view will not be displayed. Thus the
name dotfiles.
This repository is managed by GNU Stow, a free, portable, lightweight symlink farm manage. Unlike many other management tools, GNU Stow can be found in most Linux distributions. macOS users can install via homebrew.
OS | Install |
---|---|
Arch | pacman -S stow |
Ubuntu | apt-get install stow |
Fedora | dnf install stow |
Alpine | apk add stow |
macOS | brew install stow |
So how to apply configurations from this repository?
-
First, you have to clone the repository and change directory to it.
$ git clone https://github.com/ikalnytskyi/dotfiles $ cd dotfiles
-
Second, you have use
stow
to create symlinks in your home directory to point to the configuration stored in the repository. Please note,stow
doesn't provide a single command to apply all configurations. You have to choose what configuration package you want to apply first.Each configuration package is stored in the separate directory in the repository root and is named after the software it stores configuration for.
$ stow -t ~ {package}
See configuration packages for the whole list of configuration packages stored here.