https://github.com/steadywool/homelab-playbook

Configure multiple services with Ansible
https://github.com/steadywool/homelab-playbook

ansible debian docker homelab proxmox self-hosted wireguard

Last synced: about 2 months ago
JSON representation

Configure multiple services with Ansible

• Host: GitHub
• URL: https://github.com/steadywool/homelab-playbook
• Owner: steadywool
• License: gpl-3.0
• Created: 2024-04-22T12:17:17.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2024-11-20T21:26:51.000Z (about 2 months ago)
• Last Synced: 2024-11-20T22:41:16.327Z (about 2 months ago)
• Topics: ansible, debian, docker, homelab, proxmox, self-hosted, wireguard
• Language: Jinja
• Homepage:
• Size: 249 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# 🐋 Homelab Playbook

Create containers with Ansible.

## 🚀 Installation

> [!IMPORTANT]

> Important variables are present in `group_vars` and `host_vars`. You need to edit them to customize your installation.

> You must also edit the `inventory` file, playbooks and other files using hosts.

Firstly, install Ansible:

```

# apt install ansible

```

You can then clone this repository and enter it:

```

$ git clone https://github.com/steadywool/homelab-playbook.git

$ cd homelab-playbook

```

> [!IMPORTANT]

> If you need a "sudo" password, use the `-K` (upper-case) argument. 

> If you don't use SSH keys, add the `-k` (lower-case) argument. 

> If you use an Ansible Vault, add the `-J` argument.

All playbooks are in the `playbooks` directory. Choose one and execute it:

```

$ ansible-playbook playbooks/PLAYBOOK_FILE.yml

```

## ✨ Configuration

You can perform partially run of playbook using tags.

You can list them with this command:

```

$ ansible-playbook playbooks/PLAYBOOK_FILE.yml --list-tags

```

Then use them with the `-t TAG` parameter.

You can skip some tags using the `--skip-tags TAG` parameter.

You can also run playbooks on hosts of your choice with the `--limit HOST` argument.