Dotfiles Repo

Simple dotfiles with an installation script.

What are Dotfiles?

Dotfiles are configuration files for Unix-like systems, named for their leading dot (e.g., .bashrc, .vimrc). This repo stores my personal configs for easy setup across machines.

Installation

Installation steps for Debian-based systems:

1. Clone the repository:

git clone https://github.com/Piotr1215/dotfiles.git
cd dotfiles/install

2. Run the installation:

chmod +x install.sh
./install.sh

The installation script will:

1. Install ansible if not present
2. Run the ansible playbook which will:
   • Configure git with your credentials
   • Install and configure all necessary tools and programs
   • Set up development environment (neovim, tmux, etc.)
   • Configure shell environment (zsh, oh-my-zsh)
   • Install DevOps tools (kubectl, helm, etc.)

Advanced Usage

You can run specific parts of the installation using Ansible tags:

# List all available tasks
ansible-playbook install.yml --list-tasks

# Install specific components (e.g., just Alacritty)
ansible-playbook install.yml --tags "alacritty"

Or run remotely:

• bash -c "$(curl -fsSL https://raw.githubusercontent.com/Piotr1215/dotfiles/master/install.sh)"

• curl https://raw.githubusercontent.com/Piotr1215/dotfiles/master/install.sh | bash -s -- ${GIT_USERNAME} ${GIT_EMAIL} ${GPG_KEY}

Runing ./install will

• configure git with given user and email (default values point to my user)
• install a bunch of programs and symlink them using stow
• set up shell environment with zsh and oh-my-zsh configuration
• most notably, install neovim and configure its plugins

Note

Symlinks:

Any existing dotfiles will be pulled into the dotfiles repo, please make sure that you are not overwriting anything you don't want to. Check git status before committing.

The installation script is using stow to symlink whole directories and exclude others. You can symlink additional directories like so:

stow --target=/home/decoder/.config/tmuxinator tmuxinator

Adding new directory or file to the dotfiles repo can be done with the __dotfiles_adder.sh script

Encrypted Files

This repository uses git-crypt for encrypting sensitive files. The following files are encrypted:

• .vsnip/global.json — VSCode snippets file

Setting up git-crypt for new devices

After cloning the repository, you'll need the encryption key to decrypt these files:

# Install git-crypt (Debian/Ubuntu)
sudo apt install git-crypt

# For other systems, see: https://github.com/AGWA/git-crypt#installing-git-crypt

# Copy the encryption key to your new machine
# (securely transfer the .keys/git-crypt-key file)

# Unlock the repository with the key
git-crypt unlock /path/to/git-crypt-key

Once unlocked, encrypted files will automatically be decrypted when checked out and encrypted when committed.

Testing

Creating user is only required for testing, in real installation you should already have a user (the script assumes you are running as a user).

Create a user, in my case username is decoder, and switch to the user directory.

For testing purposes, password is "test", use real password for real installation ofc :)

wget https://raw.githubusercontent.com/Piotr1215/dotfiles/master/create-test-user.sh

sudo chmod +x chreate-test-user.sh
./create-test-user.sh -u "decoder" -p "testingme"
sudo passwd decoder
su decoder
cd

The setup was tested on:

Last test date: 2024-12-29

• Ubuntu 20.04 vm

---

License

All files and scripts in this repo are released CC0 / kopimi! In the spirit of freedom of information, I encourage you to fork, modify, change, share, or do whatever you like with this project!