https://github.com/jessfraz/dotfiles
My dotfiles. Buyer beware ;)
https://github.com/jessfraz/dotfiles
bash containers docker dotfiles linux shell
Last synced: 22 days ago
JSON representation
My dotfiles. Buyer beware ;)
- Host: GitHub
- URL: https://github.com/jessfraz/dotfiles
- Owner: jessfraz
- License: mit
- Created: 2015-06-06T20:46:47.000Z (over 11 years ago)
- Default Branch: main
- Last Pushed: 2026-09-18T04:32:18.000Z (about 2 months ago)
- Last Synced: 2026-09-20T03:34:48.509Z (about 2 months ago)
- Topics: bash, containers, docker, dotfiles, linux, shell
- Language: Shell
- Homepage:
- Size: 261 MB
- Stars: 3,564
- Watchers: 112
- Forks: 507
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-list-docker - dotfiles
- awesome-starred - jessfraz/dotfiles - My dotfiles. Buyer beware ;) (docker)
- jimsghstars - jessfraz/dotfiles - My dotfiles. Buyer beware ;) (Shell)
- awesome - jessfraz/dotfiles - My dotfiles. Buyer beware ;) (Shell)
README
# dotfiles
[](https://github.com/jessfraz/dotfiles/actions?query=workflow%3A%22make+test%22+branch%3Amaster)
**Table of Contents**
- [About](#about)
* [Installing](#installing)
* [Customizing](#customizing)
- [Resources](#resources)
* [`.vim`](#vim)
- [Contributing](#contributing)
* [Running the tests](#running-the-tests)
## About
### Installing
For Nix, import `homeManagerModules.default` from this flake through Home
Manager. The host configuration supplies the username, home directory, and
state version. [global-nix](https://github.com/jessfraz/global-nix) also enables
Bash completion and installs the Zoo and rustup completion files used by the
`.nixbash` startup fragment.
For the legacy Linux installation:
```console
$ make
```
This will create symlinks from this repo to your home folder.
### Customizing
Save env vars, etc in a `.extra` file, that looks something like
this:
```bash
###
### Git credentials
###
GIT_AUTHOR_NAME="Your Name"
GIT_COMMITTER_NAME="$GIT_AUTHOR_NAME"
git config --global user.name "$GIT_AUTHOR_NAME"
GIT_AUTHOR_EMAIL="email@you.com"
GIT_COMMITTER_EMAIL="$GIT_AUTHOR_EMAIL"
git config --global user.email "$GIT_AUTHOR_EMAIL"
GH_USER="nickname"
git config --global github.user "$GH_USER"
###
### Gmail credentials for mutt
###
export GMAIL=email@you.com
export GMAIL_NAME="Your Name"
export GMAIL_FROM=from-email@you.com
```
## Resources
### `.vim`
For my `.vimrc` and `.vim` dotfiles see
[github.com/jessfraz/.vim](https://github.com/jessfraz/.vim).
## Contributing
### Running the tests
Run the native Nix checks, including a complete Home Manager fixture and an
editor smoke test:
```console
$ nix flake check --no-update-lock-file
```
CI builds these checks on x86-64 Linux, ARM Linux, and ARM macOS. The
`homeConfigurations` outputs are test fixtures, not host profiles; do not
activate them.
The shell scripts are also checked with
[shellcheck](https://github.com/koalaman/shellcheck) in a container:
```console
$ make test
```