Deploy Lidarr¶

Use the following steps to deploy Lidarr. Use the same process is used to update Lidarr.

Set Version to Deploy¶

Edit inventory/services/group_vars/lidarr/main.yml and set the variable, lidarr_setup_version to the version to deploy. Find the latest stable version of Lidarr from Lidarr's GitHub Versions page. Look for the 'latest' build tag....

Getting Started with Ansible¶

Python Requirement¶

The following requires that Python3 is installed. Python 3.12 is currently what is set as a standard. Install Python and required packages with the following command:

sudo rm -f /etc/apt/sources.list.d/deadsnakes-ubuntu-ppa-noble.sources...

Reverse Proxy Explained¶

This document details on how a reverse proxy is used in my home lab. A reverse proxy redirects incoming traffic for a website to its host.

What is a Reverse Proxy¶

It secures the host by obfuscation and direct access. It improves performance by load-balancing traffic to multiple servers, caching content and provides SSL termination by handling encryption and decryption of data....

Azure Powershell Module¶

The following provide documentation on using Azure Powershell in my home lab.

Installation¶

Azure Powershell module can be installed using an Ansible playbook.

ansible-playbook -i inventory/ansible/inventory.ini -k playbooks/azure/deploy_azure_ps.yml...

Virtual Machine Operations Ansible Playbooks¶

The following document lists Ansible playbooks that is used to manage virtual machines. Note the Examples uses the $INV variable to represent the path to an inventory file.

|Playbook |Description | Example |...

Updating Plex Media Server¶

Use the following steps to deploy a Plex Media Server update.

Update Version¶

Edit the plex_setup_version variable located in inventory/plex/group_vars/all/main.yml to the version of Plex Media Server to update to....

Updating Pi-hole DNS Servers¶

Use the following steps to update Pi-hole DNS Servers update.

Update Version¶

The Pi-hole interface will show when an update is available.

Login to an Ansible Control Node¶

Login to an Ansible control node and set the following to prep the playbook execution....

Ansible Inventory List¶

The following is a list of hosts that are managed by Ansible. The list was extracted from the list of Ansible inventory files using the following shell script. Note that this requires the jq utility to parse the JSON output. This command is typically not installed in Ubuntu....

Request Certificates for code.refol.us and semaphore.refol.us¶

Use the following steps to request web certificates for code.refol.us and semaphore.refol.us. These two web services are hosted in the same host.

Login to an Ansible Control Node...¶

Deploy SemaphoreUI¶

Use the following steps to deploy deploy SemaphoreUI. Use the same steps to update an existing deployment.

Update Version¶

Edit the semaphoreui_setup_version variable located in inventory/ansible/group_vars/semaphore/main.yml to the version of SemaphoreUI to update to....

Request Certificates for homelab.refol.us¶

Use the following steps to request web certificates for homelab.refol.us.

Login to an Ansible Control Node¶

Login to an Ansible control node and set the following to prep the playbook execution....

Request Certificates for Services Inventory¶

Use the following steps to request web certificates for services inventory. The following host certificates will be requested:

• lidarr.refol.us
• radarr.refol.us
• sabnzbd.refol.us
• sonarr.refol.us...

Deploy Sonarr¶

Use the following steps to deploy Sonarr. Use the same process is used to update Sonarr.

Set Version to Deploy¶

Edit inventory/services/group_vars/sonarr/main.yml and set the variable, sonnar_setup_version to the version to deploy. Find the latest stable version of Sonarr from Sonarr's GitHub Versions page. Look for the 'latest' build tag....

Updating Minecraft Bedrock Edition¶

Use the following steps to deploy a Minecraft Bedrock Edition update.

Update Version¶

Edit the bedrock_setup_version variable located in inventory/minecraft/group_vars/all/main.yml to the version of Bedrock to update to....

Deploy Radarr¶

Use the following steps to deploy Radarr. Use the same process is used to update Radarr.

Set Version to Deploy¶

Edit inventory/services/group_vars/radarr/main.yml and set the variable, radarr_setup_version to the version to deploy.F ind the latest stable version of Radarr from Radarr's GitHub Versions page. Look for the 'latest' build tag....

Provision a new Virtual Machine¶

Use these standard operating procedure to provision a virtual machine. Note that currently this only supports an Ubuntu virtual machine.

Prep¶

1. Create Inventory file

[vms]
host-1 vms_proxmox_node=pve-1 vms_clone=false...

Deploy Linux Security Updates using Ansible¶

Use the following steps to deploy Linux security updates using Ansible. Note that this can possibly restart the target host if required.

Login to an Ansible Control Node¶

Login to an Ansible control node and set the following to prep the playbook execution....

Deploy Sabnzbd¶

Use the following steps to deploy Sabnzbd. Use the same process is used to update Sabnzbd.

Set Version to Deploy¶

Edit inventory/services/group_vars/sabnzbd/main.yml and set the variable, sabnzbd_setup_version to the version to deploy. Find the latest stable version of Sabnzbd from Sabnzbd's GitHub Versions page. Look for the 'latest' build tag....

Deploy Calibre-web¶

Use the following steps to deploy Deploy Deploy Calibre-web. Use the same process is used to update Deploy Lazy Librarian.

Set Version to Deploy¶

Edit inventory/services/group_vars/calibre/main.yml and set the variable, calibreweb_setup_version to the version to deploy. Find the latest stable version of Calibre-web from Calibre-web's GitHub Versions page. Look for the 'latest' build tag....

Deploy Lazy Librarian¶

Use the following steps to deploy Deploy Lazy Librarian. Use the same process is used to update Deploy Lazy Librarian.

Set Version to Deploy¶

Edit inventory/services/group_vars/lazylibrarian/main.yml and set the variable, lazylibrarian_setup_version to the version to deploy. Find the latest stable version of Lazy Librarian from Lazy Librarian's GitHub Versions page. Look for the 'latest' build tag....

Linux Utilities Ansible Playbooks¶

The following list playbooks that are used to provide troubleshooting information when executed against a Linux host.

Deploy an Ansible Control Node¶

Use the following steps to deploy deploy an Ansible control node. Use the same steps to update an existing deployment.

Update Version¶

TBD

The SemaphoreUI releases are available in https://github.com/semaphoreui/semaphore/releases....

Updating Code Server¶

Use the following steps to deploy a Code Server update.

Update Version¶

Go to https://github.com/coder/code-server/releases to determine the latest version. Edit the code_server_version variable located in inventory/ansible/group_vars/code_server/main.yml to the version of Code Server to update to....

Updating Proxmox Cluster¶

The Proxmox Cluster consists of three nodes, pve-0, pve-1, pve-2. The update is performed individually for each node. Perform the update in the order of, pve-2, pve-1, pve-0.

This process updates operating system components as well as Linbit....

Use the following command to to list all virtual machines hosted in a Proxmox node. Connect to the node's console and perform the following

for vm in $(sudo qm list | awk '{print $1}' | grep -Eo '[0-9]{1,3}'); do echo $vm;done