jbrinkmann/dotfiles repository overview

⁠dotfiles

sensible hacker defaults focused towards a reusable Debian (Stretch⁠) docker runtime environment

⁠Contents

• About⁠
• Dependencies⁠
• Usage⁠
• Development⁠
• Contributing⁠
• Meta⁠

⁠About ↟⁠

The project has multiple main topics, summarized here:

• dotfiles: the "runcoms⁠" (init configs) of the tools I use
• setups: scripts to bootstrap the installation of tools
• docker: pre-existing environment with all tools installed
• ci: run builds after every pushed commit

It is expected that this project only contains generic tools. Other language-specific environments are then children of this base project.

However, the dotfiles and setups should work on any debian system, and not be coupled to Docker/CI.

⁠Dependencies ↟⁠

These tools must first be installed on the system:

• Docker⁠

⁠Usage ↟⁠

To quickly run the pre-built environment:

docker pull jbrinkmann/dotfiles:latest

This project has a quick-start to jump into the latest image:

# Note: this will run a release version tag
#       which should match the `:latest` tag
make run

⁠Development ↟⁠

To Download/Install this project directly onto a host machine (helpful when I want to fly native on a machine, without the additional overhead of containers... trading off for reproducibility in my environment, though):

git clone [email protected]:jakebrinkmann/dotfiles.git ~/.dots
cd ~/.dots
bash setup.sh

To build the Docker image locally:

# docker build ...
make image

⁠Contributing ↟⁠

No contribution is too small!

⁠Meta ↟⁠

Jake Brinkmann – @jakebrinkmann⁠ – [email protected]⁠

Distributed under the MIT license. See LICENSE.txt for more information.

This project adheres to Semantic Versioning⁠ and Conventional Commit Messages⁠.

https://github.com/jakebrinkmann/dotfiles⁠

↟ Back to Top ↟⁠