48 lines
1.2 KiB
Markdown
48 lines
1.2 KiB
Markdown
# Dotfiles
|
|
Dotfiles managed by [chezmoi](https://www.chezmoi.io/). The repo works on
|
|
Arch and Ubuntu (not complete) and has three machine classes: **server**, **desktop**, and **laptop**.
|
|
|
|
|
|
## First-time install on a new machine
|
|
### 1. Install prerequisites
|
|
```bash
|
|
# Arch
|
|
sudo pacman -S git curl age jq chezmoi
|
|
|
|
# Ubuntu
|
|
sudo apt-get install git curl age jq chezmoi
|
|
```
|
|
|
|
### 2. Encryption key
|
|
The age key needs to be placed at `~/.config/chezmoi/key`
|
|
With following permissions
|
|
```bash
|
|
chmod 600 ~/.config/chezmoi/key
|
|
```
|
|
|
|
### 3. Init and Apply
|
|
```bash
|
|
chezmoi init --apply https://gitea.keuledrive.de/Keule2/Dotfiles
|
|
```
|
|
Will prompt some questions for template data.
|
|
|
|
## Usage
|
|
| Command | Effect |
|
|
|---|---|
|
|
| `chezmoi apply` | apply any local changes to dotfiles and run-once scripts |
|
|
| `chezmoi update` | `git pull` + `apply` |
|
|
| `chezmoi edit <file>` | open a tracked file in `$EDITOR` |
|
|
| `chezmoi cd` | shell into the source dir |
|
|
| `chezmoi diff` | show pending changes against your home |
|
|
| `chezmoi managed` | list files chezmoi manages |
|
|
|
|
## Changing the system class
|
|
Edit the config file
|
|
```bash
|
|
$EDITOR ~/.config/chezmoi/chezmoi.toml # change [data].system
|
|
chezmoi apply
|
|
```
|
|
|
|
## TODO
|
|
- Check packages e.g. gaming Steam/Lutris
|