https://github.com/flaudisio/linux-setup-playbook
Linux setup using Ansible.
https://github.com/flaudisio/linux-setup-playbook
ansible ansible-roles
Last synced: 3 months ago
JSON representation
Linux setup using Ansible.
- Host: GitHub
- URL: https://github.com/flaudisio/linux-setup-playbook
- Owner: flaudisio
- License: mit
- Created: 2017-07-07T05:32:10.000Z (almost 8 years ago)
- Default Branch: main
- Last Pushed: 2025-02-25T12:05:59.000Z (4 months ago)
- Last Synced: 2025-03-21T11:09:51.797Z (3 months ago)
- Topics: ansible, ansible-roles
- Language: Shell
- Homepage:
- Size: 684 KB
- Stars: 16
- Watchers: 3
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Linux Setup Playbook
Ansible playbooks and roles that I use to provision my Linux-based machines.
## Compatibility
This repository is currently tested against **Xubuntu 24.04**, but most roles should work with any Ubuntu
flavor running the same version.
## Prerequisites
- Git
- Python [venv](https://docs.python.org/3/library/venv.html) module
The installation steps below take care of bootstrapping a default (X)Ubuntu installation.
## Installation
Run the [installation script](install.sh) and follow its instructions:
```bash
wget -q -O - https://raw.githubusercontent.com/flaudisio/linux-setup-playbook/refs/heads/main/install.sh | bash
```
> Notice that `curl` may not be available in vanilla Ubuntu installations.
The script will:
- Install Git and Python's [venv](https://docs.python.org/3/library/venv.html) module package (`python3-venv`)
- Clone this repository
- Install Ansible in a virtualenv and download the required collections/roles to the cloned folder
## Overriding defaults
You can override variables defined in `config.default.yml` (or define new ones) by creating a `config.yml`
file.
Example:
```yaml
# Customize the list of installed packages
packages_apt_install:
- htop
- jq
- vim
packages_pipx_install:
- pre-commit
# Clear the custom Docker daemon options by setting an empty object
docker_daemon_options: {}
```
For all available options, see the roles' variable files in the [local roles](roles/local) folder.
## Running the playbook
Run the `setup` playbook:
```bash
cd ~/.local/share/linux-setup-playbook
./run.sh setup.yml
```
The [run.sh](run.sh) script is a tiny wrapper for the `ansible-playbook` command. By default it uses
the `--become --ask-become-pass` arguments, so your user must be able to use `sudo` (which is default
on clean Ubuntu installations).
## Running specific tasks
Use `ansible-playbook`'s flags like `--tags` (shorthand: `-t`) to run only specific tasks, enable check
mode and so on.
Example:
```bash
./run.sh setup.yml --list-tasks
./run.sh setup.yml -t backup -t spotify
./run.sh setup.yml -t packages -t restic
./run.sh setup.yml -t spotify --diff -C
```
## Thanks
This project is heavily inspired by Jeff Geerling's great [Mac Development Ansible Playbook](https://github.com/geerlingguy/mac-dev-playbook).
## License
[MIT](LICENSE)