Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mkasberg/dotfiles
🛠️ Mike's dotfiles. Managed with https://www.chezmoi.io/
https://github.com/mkasberg/dotfiles
chezmoi config dotfiles linux zsh
Last synced: about 2 months ago
JSON representation
🛠️ Mike's dotfiles. Managed with https://www.chezmoi.io/
- Host: GitHub
- URL: https://github.com/mkasberg/dotfiles
- Owner: mkasberg
- License: other
- Created: 2020-04-10T18:01:12.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-07-25T21:30:26.000Z (2 months ago)
- Last Synced: 2024-07-26T00:11:12.812Z (2 months ago)
- Topics: chezmoi, config, dotfiles, linux, zsh
- Language: Vim Script
- Homepage:
- Size: 1.85 MB
- Stars: 45
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Mike Kasberg's Dotfiles
Managed with [chezmoi](https://www.chezmoi.io) ❤️
## Setup dotfiles on a new machine
1. (Optional) Install [Bitwarden](https://bitwarden.com/) and login if you plan to install secrets.
**Linux**
```
sudo snap install bw
bw login
```
**macOS**
```
curl -o ~/bin/bw.zip -L 'https://vault.bitwarden.com/download/?app=cli&platform=macos'
unzip -d ~/bin ~/bin/bw.zip && rm ~/bin/bw.zip
bw login
```
2. [Install chezmoi](https://www.chezmoi.io/docs/install/) to `~/bin` and
install dotfiles to `~/dotfiles`.
```
sh -c "$(curl -fsLS git.io/chezmoi)" -- -b "$HOME/bin" init --apply -S ~/dotfiles mkasberg
```
Done! To keep up to date in the future:
chezmoi update
Want to check the diff before applying changes?
chezmoi -nv
## Notable Features
* Cross-platform (macOS & Linux)
* Scripts to install [system](run_once_01-install-ubuntu-applications.sh.tmpl)
and [user](run_once_02-user-installs.sh.tmpl) applications and preferences
* Custom [PS1 Bash Prompt](https://github.com/mkasberg/dotfiles/blob/1cf2a9c5787fa326ff2228414117beb479145147/dot_bashrc#L63-L64)
* Custom [Oh My Zsh Theme](dot_zsh_custom/themes/mkasberg.zsh-theme)
* Set the default shell to [zsh](https://github.com/mkasberg/dotfiles/blob/1cf2a9c5787fa326ff2228414117beb479145147/run_once_02-user-installs.sh.tmpl#L8-L13) on Ubuntu
* Per-machine [git email](https://github.com/mkasberg/dotfiles/blob/1cf2a9c5787fa326ff2228414117beb479145147/dot_gitconfig.tmpl#L4), set once during setup
* Optionally (per machine) install [secrets from Bitwarden](https://github.com/mkasberg/dotfiles/blob/1cf2a9c5787fa326ff2228414117beb479145147/.chezmoi.toml.tmpl#L22-L27)
* [Install script](install.sh) for [VS Code Remote Containers Dotfiles](https://code.visualstudio.com/docs/remote/containers#_personalizing-with-dotfile-repositories)
* [Vim filetypes for chezmoi](dot_vim/ftdetect/chezmoi.vim)
## Start Your Own Dotfiles
Want to use Chezmoi to manage your own dotfiles? The best way to get started is
to follow the [Chezmoi Quick Start
Guide](https://www.chezmoi.io/docs/quick-start/) to start tracking your first
dotfile (`~/.bashrc`, `~/.zshrc`, or `~/.gitconfig` are great files to start
with). Beyond that, I hope you can find some inspiration by looking at my
dotfiles and copying things you like!
## Testing
Want to test a fresh install on a new machine? A dev container in Docker is
great for this because it comes with a non-root user. Use the Docker command
below to get into a fresh, disposable testing environment, then run the
installation steps from above.
docker run --rm -it --user vscode --workdir /home/vscode mcr.microsoft.com/devcontainers/base:ubuntu
For convenience, `./test.sh` use the above to install dotfiles from the current
working directory and drop you into a prompt.
## Security
Did you find a vulnerability in my dotfiles? An exposed secret? Some other
security issue? Please report vulnerabilities via email to
[[email protected]](mailto:[email protected]) or
[[email protected]](mailto:[email protected]).