Dev Bootstrap

Easily set up a new computer with developer tools in under 10 minutes.

These automations have been tested on: MacOS, Ubuntu and Arch Linux.

How to use

On MacOS/Ubuntu

Download this repository, go to the root folder of the repository and run:

./bootstrap.sh

Enter the sudo password when prompted for the BECOME password and sit back while ansible does all the hard work.

On Arch

Arch usually doesn't come with unzip preinstalled, so the best option is to use bsdtar, which comes preinstalled, to unzip the downloaded contents.

Here's a one-liner to download this repository as a zip file, unzip it using bsdtar and cd into the repository folder:

curl -L -o ~/Downloads/dev-bootstrap.zip https://github.com/lily-gh/dev-bootstrap/archive/refs/heads/main.zip && cd ~/Downloads && bsdtar -xf dev-bootstrap.zip && cd dev-bootstrap-main

Then run:

./bootstrap.sh

Enter the sudo password when prompted for the BECOME password and sit back while ansible does all the hard work.

Packages

The playbook in this repository ensures that the following packages/apps are installed:

• bat
• ffmpeg
• fzf
• git
• gpg
• eza
• ansible
• asdf
• neovim
• zsh
• zsh-syntax-highlighting
• zsh-autosuggestions
• oh-my-zsh
• powerlevel10k
• vlc
• telegram
• 1password

How it works

The main bootstrap.sh script will check if ansible is installed in the system, and install it if it's not already installed, then, it will use ansible to start the main playbook with the following command:

ansible-playbook main.yml --ask-become-pass

When I (Lily) run the script, I pass in an additional parameter lily when running bootstrap.sh, this causes the script to execute an additional ansible playbook and uses an additional argument:

ansible-playbook main.yml lily.yml --ask-become-pass --ask-vault-pass

The lily.yml playbook imports two other playbooks that are used to setup my ssh key and download one of my private repos:

- import_playbook: tasks/setup-ssh.yml
- import_playbook: tasks/clone-lilydevtools.yml 

The parameter --ask-vault-pass prompts me for a password to decrypt the ssh key in this repository.

Future Ideas

Configuration Wizard

A web-based wizard to help users generate customized Ansible configuration files for their development environment. Similar to Spring Initializr, this tool would:

• Provide an interactive interface to select desired tools, languages, and frameworks
• Allow users to configure version preferences and optional features
• Generate a tailored playbook.yml and variable files based on selections
• Offer a preview of what will be installed before downloading
• Enable quick bootstrapping without manually editing configuration files

This would lower the barrier for users unfamiliar with Ansible syntax while maintaining the flexibility of the underlying automation.

Quality Certificate