Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sdsc-ordes/dotfiles

dotfiles with chezmoi - a starter configuration
https://github.com/sdsc-ordes/dotfiles

Last synced: about 14 hours ago
JSON representation

dotfiles with chezmoi - a starter configuration

Awesome Lists containing this project

README

        



Dotfiles Starter Repository


A starter repository to get you started with `chezmoi` and your precious config
files on your system (dotfiles).

## How Does It Work?

This repository acts as a repository for [`chezmoi`](https://www.chezmoi.io).
The tool `chezmoi` manages your configuration files between a Git repo to your
`$HOME` directory (or somewhere else).

In this repo only `zsh` and `git` config files are managed for you as a starter
config. The ZSH setup is a nice structured setup which provides the basic.

The tool `chezmoi` default behavior works by first initiating it with
`chezmoi init ` which will clone the `` by default to
`~/.config/local/chezmoi`. Any `chezmoi apply` will take managed files in your
[`config`](./config) and apply it to your `$HOME` folder (if you made change for
any managed files in your home folder, `chezmoi` will prompt you to overwrite).

## Test Setup in Container

```shell
just test-in-container
# or with docker
just container_mgr=docker test-in-container
```

This will log you into ZSH in a container (to not mess with your system) to test
out the ZSH and Git settings and to get a look and feel of Chezmoi.

For the impatient do `just test-in-container --apply`, for the ones wanting a
follow through jump through the next sections.

### Initialize `chezmoi`

```shell
cd ~/workspace
chezmoi init ./
```

### Apply all Configuration Files

```
cd ~/.local/config/chezmoi
chezmoi apply
```

and inspect the changes with

```shell
tree ~/.config
```

### Login again into ZSH

```shell
zsh
```

Which will directly use all config files, install ZSH plugin on startup and
present you with a nice prompt like this:

```text
╭─   ~/.local/share/chezmoi on   master ·······························································································  impure
╰─❯
```