|
|
@@ -6,13 +6,77 @@ The repository lives at `git.beckesch.it:beckesch/dotfiles.git` and is kept loca
|
|
|
under `~/.local/share/chezmoi`.
|
|
|
|
|
|
## Quick start (new machine)
|
|
|
+### Install script from chezmoi.io
|
|
|
|
|
|
```sh
|
|
|
sh -c "$(curl -fsLS get.chezmoi.io)" -- -b ~/.local/bin init --apply git@git.beckesch.it:beckesch/dotfiles.git
|
|
|
```
|
|
|
|
|
|
+### Install with your distros or cross-platform package manager first...
|
|
|
+...then initialize chezmoi with the repository
|
|
|
+
|
|
|
+```
|
|
|
+chezmoi init git@git.beckesch.it:beckesch/dotfiles.git
|
|
|
+```
|
|
|
+### Autosetup the files inside your devpods
|
|
|
+
|
|
|
Alternatively, use the `setup.sh` script in this repository, which installs chezmoi
|
|
|
-and applies the dotfiles if that hasn't happened yet.
|
|
|
+and applies the dotfiles if that hasn't happened yet. The `setup.sh` is intended to be used as `devpod` quick setup.
|
|
|
+
|
|
|
+see `setup.sh`
|
|
|
+
|
|
|
+### Use your distros package manager
|
|
|
+```
|
|
|
+# Alpine
|
|
|
+apk add chezmoi
|
|
|
+
|
|
|
+# Arch
|
|
|
+pacman -S chezmoi
|
|
|
+
|
|
|
+# Debian
|
|
|
+apt-get install chezmoi
|
|
|
+
|
|
|
+# Fedora
|
|
|
+dnf install chezmoi
|
|
|
+
|
|
|
+# NixOS
|
|
|
+nix-env -i chezmoi
|
|
|
+
|
|
|
+# openSUSE Tumbleweed
|
|
|
+zypper install chezmoi
|
|
|
+
|
|
|
+# RHEL (EPEL)
|
|
|
+dnf install epel-release && dnf install chezmoi
|
|
|
+
|
|
|
+# Termux
|
|
|
+pkg install chezmoi
|
|
|
+
|
|
|
+# Void
|
|
|
+xbps-install -S chezmoi
|
|
|
+```
|
|
|
+
|
|
|
+### Cross-platform package managers
|
|
|
+```
|
|
|
+# am
|
|
|
+am -i chezmoi
|
|
|
+
|
|
|
+# asdf
|
|
|
+asdf plugin add chezmoi && asdf install chezmoi 2.72.2
|
|
|
+
|
|
|
+# mise
|
|
|
+mise use --global chezmoi@2.72.2
|
|
|
+
|
|
|
+# Homebrew
|
|
|
+brew install chezmoi
|
|
|
+
|
|
|
+# Nix
|
|
|
+nix-env -i chezmoi
|
|
|
+
|
|
|
+# Snap
|
|
|
+snap install chezmoi --classic
|
|
|
+```
|
|
|
+
|
|
|
+
|
|
|
|
|
|
## Structure
|
|
|
|
|
|
@@ -20,7 +84,7 @@ and applies the dotfiles if that hasn't happened yet.
|
|
|
| --- | --- |
|
|
|
| `dot_bashrc` | Entry point for `~/.bashrc`; loads all snippets from `~/.bashrc.d` (interactive shells only) |
|
|
|
| `dot_bashrc.d/` | Modular bash config snippets, loaded in alphabetical/numeric order |
|
|
|
-| `dot_bashrc.d/applications/` | Application-specific aliases and additions (e.g. chezmoi, kubernetes, devpod, containerlab, starship, ssh, lsd) |
|
|
|
+| `dot_bashrc.d/applications/` | Application-specific aliases and additions, loaded by `150-applications.sh` (cd, chezmoi, containerlab, date, devpod, grep, kubernetes, ls/lsd, mkdir, ssh, starship, sudo, vi/nvim) |
|
|
|
| `dot_config/` | Config files under `~/.config/` (e.g. symlink to `starship.toml`) |
|
|
|
| `empty_dot_bash_aliases` | Empty `~/.bash_aliases` file (placeholder) |
|
|
|
| `setup.sh` | Bootstrap script: installs chezmoi and applies the repository |
|
|
|
@@ -31,11 +95,12 @@ The numbered files in `dot_bashrc.d/` are sourced in this order:
|
|
|
|
|
|
1. `000-bash-setup-generic.sh` – basic shell setup
|
|
|
2. `010-bash-account-specific.sh` – account-/machine-specific settings
|
|
|
-3. `100-generic-aliases.sh` / `100-applications.sh` – general aliases, loads the snippets in `applications/`
|
|
|
-4. `200-networking.sh` – networking aliases and helpers
|
|
|
-5. `300-shell-safety-nets.sh` – safety nets (e.g. safer aliases)
|
|
|
+3. `100-generic-aliases.sh` – general aliases
|
|
|
+4. `150-applications.sh` – loads all snippets in `applications/`
|
|
|
+5. `200-networking.sh` – networking aliases and helpers
|
|
|
+6. `300-shell-safety-nets.sh` – safety nets (e.g. safer aliases)
|
|
|
|
|
|
-Files with a `.sh-off` suffix (e.g. `mybashrc.sh-off`) are intentionally not loaded.
|
|
|
+Files with a suffix not equal to `.sh` (e.g. `mybashrc.sh-off`) are intentionally not loaded.
|
|
|
|
|
|
## Common workflows
|
|
|
|
