This repo is archived. I no longer plan to maintain it. You are welcome to do anything permitted by the LICENSE.
Why, see this article about NixOS vs Ansible for more details.
This playbook installs and configures most of the software I use on my Ubuntu Installations for web and software development. Some things are slightly difficult to automate, so I still have a few manual installation steps, but at least it's all documented here.
-
- Upgrade Pip:
python3 -m pip install --upgrade pip - Run the following command to add Python 3 to your $PATH:
export PATH="$HOME/.local/bin:$PATH" - Install Ansible:
python3 -m pip install ansible
- Upgrade Pip:
-
Clone or download this repository to your local drive.
-
Run
ansible-galaxy install -r requirements.ymlinside this directory to install required Ansible roles. -
Run
ansible-playbook playbook_terminal.yml --ask-become-passinside this directory. Enter your sudo account password when prompted for the 'BECOME' password. -
(if desired) Run
ansible-playbook playbook_desktop.yml --ask-become-passinside this directory. Enter your sudo account password when prompted for the 'BECOME' password.
Note: If some commands fail, you might need logout and log back in again.
For a new machine, I run the following command to set up my computer:
Please make sure you adjust your hostname as Ansible keys off this variable. I like to do this during the initial configuration of the machine.
This will prompt you for your sudo password
for the bash script and then once later for
ansible's "BECOME PASSWORD" prompt.
Voila! 🎉🎉🎉
wget -qO- \
https://github.com/iancleary/ubuntu-dev-playbook/raw/main/run_terminal.sh | \
bashwget -qO- \
https://github.com/iancleary/ubuntu-dev-playbook/raw/main/run_desktop.sh | \
bashNote I run both the playbook_terminal.yml and playbook_desktop.yml as they are mutually exclusive. In older releases, they were a single playbook, but I've separated them.
Not everyone's development environment and preferred software configuration is the same.
You can override any of the defaults configured in group_vars by creating a config.yml file and setting the overrides in that file.
For example, you can customize the installed packages and apps with something like:
apt_packages:
- python3.10
- git
- nala
nodejs_version: "18.x"
# Set to true to suppress the UID/GID switching when running package scripts. If
# set explicitly to false, then installing as a non-root user will fail.
npm_config_unsafe_perm: true
npm_global_packages:
- name: "yarn"
- name: "vercel"
gem_packages:
- name: bundler
state: latest
pip_packages:
- name: mkdocs
pipx_packages:
- name: ruff
- name: pre-commit
snaps:
- name: "authy" # 2-Factor Authentication
- name: "beekeeper-studio" # An open source SQL editor and database management app
- name: "code"
classic: "yes"
- name: "flameshot" # Powerful yet simple to use screenshot software
- name: "slack"
classic: "yes"
- name: "chromium"
- name: "standard-notes"
# you are responsible for making sure there is a matching snap
snap_plugs:
- plug: "home"
app: "chromium"
- plug: "password-manager-service"
app: "standard-notes"
configure_flatpak: true
configure_flatpak_gnome_software: true # gnome software plugin, can turn off to avoid duplicate stores (snap-store and gnome-software)
flatpaks:
# - "net.giuspen.cherrytree" # Hierarchical Note Taking
- "io.github.seadve.Kooha" # Simple screen recorder with an easy to use interface
- "com.rafaelmardojai.Blanket" # Background Sounds
- "com.github.tchx84.Flatseal" # Manage Flatpak permissions
- "org.gabmus.whatip" # Info on your IP
- "org.libreoffice.LibreOffice"
- "org.mozilla.firefox"
- "org.videolan.VLC"
- "nl.hjdskes.gcolor3" # Color Picker
- "re.sonny.Junction"
- "com.mattjakeman.ExtensionManager"
- "ca.desrt.dconf-editor"
- "io.podman_desktop.PodmanDesktop"
gem_packages:
- name: bundler
state: present # present/absent/latest, default: present
version: "~> 1.15.1" # default: N/A
configure_code_extensions: true
code_extensions:
- # General Development
- christian-kohler.path-intellisense
- vscode-icons-team.vscode-icons
- riccardoNovaglia.missinglineendoffile
- shardulm94.trailing-spaces
- oderwat.indent-rainbow
- ms-vscode.makefile-tools
# - Shan.code-settings-sync
## Git Utilities
- eamodio.gitlens
- donjayamanne.githistory
- mhutchie.git-graph
## Markdown Linting
- DavidAnson.vscode-markdownlint
## Python Development
- ms-python.python
- himanoa.Python-autopep8
- njpwerner.autodocstring
- wholroyd.jinja
- ms-python.vscode-pylance
## Spellchecking
- streetsidesoftware.code-spell-checker
## Themes
- sdras.night-owl
- akamud.vscode-theme-onedark
## Vue.js Development
- octref.vetur
- dbaeumer.vscode-eslint
- pranaygp.vscode-css-peek
- sdras.vue-vscode-snippets
## HTML
- formulahendry.auto-close-tag
- anteprimorac.html-end-tag-labels
- vincaslt.highlight-matching-tag
- formulahendry.auto-rename-tag
Any variable can be overridden in config.yml; see the supporting roles' documentation for a complete list of available variables.
Default applications are controlled on a group basis, with hosts being localhosts. This yields a groups_vars folder for terminal and one for desktop
The folders contain the defaults, as well as some of the Ansible Galaxy Roles:
- iancleary.ohmyzsh and it's defaults
While I often setup new machines while I experiment Many people have asked me if I often wipe my entire workstation and start from scratch just to test changes to the playbook. Nope! This project is continuously tested on GitHub Actions' Ubuntu infrastructure.
This project intentionally doesn't not test the Ansible Galaxy roles that are continuously tested on Github Actions Ubuntu infrastructure elsewhere. That testing uses Docker and (generally) targets the latest Ubuntu LTS and the latest Fedora release.
This project doesn't test on Github Actions with Fedora, as that (at the time of writing) isn't easily supported with Github Actions while not using docker.
That said, I'm considering adding Fedora support (as there are just a few apt installs that would need to be expanded upon to also support rpm/dnf)
You can also run Ubuntu inside a VM.
If you do, I currently recommend:
- VirtualBox
- Easy SSH Setup for VirtualBox, this can scale to different VMs by changing which host port you forward each VM to, and changing the ssh config on the host accordingly.
Additionally, it is useful to mount a shared drive.
For Windows hosts, I've had issues with WSL while using certain VPNs (say Cisco AnyConnect). While there are likely guides on how to get WSLs DNS issues resolved under WSL2, that is not the focus of this repo. The playbook will generally work on WSL though.
Hyper-V is also possible for Virtualization, but I've had difficulties with static IP Configuration, see local-ssh-config.
Note: If you go the Hyper-V route, there is also a hyper-v role that helps set the resolution, such that the Hyper-V window on the host will be scaled to the correct resolution. In general, Hyper-V will be faster than VirtualBox, due to what layer of hypervisor each are.
If your machine is fast enough, I recommend the VirtualBox and port forwarding route. Especially useful with a shared drive and a symlink from /mnt/shared to the home directory within the virtual machine. I recommend that workflow.
This project was created by Ian Cleary, (originally inspired by Jeff Geerling).
I will support the LTS versions I use. There are no plans to support non-LTS versions.
GitHub Actions: Ubuntu 22.04 is now generally available on GitHub-hosted runners
| LTS | Last Supported Branch/Tag |
|---|---|
| Ubuntu 20.04 and 22.04 (including elementary OS 6.x and 7.x, respectively) | main |
| Ubuntu 20.04 (including elementary OS 6.0) | 2022.9.25 |
| Ubuntu 18.04 | 2020.1.0 |
I benefited from the source work of others, see AUTHORS.md.
My choice to open source my work here is to share back with you.
If you wish to contribute, see CONTRIBUTING.md