Introduction

Ansible AWX is an open-source web application that provides a user-friendly interface for managing Ansible tasks. It enables teams to control Ansible deployments easily. This guide will walk you through the installation of Ansible AWX on Debian 11, which can be effectively hosted on a Windows VPS UK for optimal performance and accessibility.

Prerequisites

• A Debian 11 server with root access
• Basic knowledge of Linux commands
• Docker and Docker Compose installed on your server

Step 1: Update Your System

Start by updating your package index and upgrading any existing packages:

sudo apt update && sudo apt upgrade -y

Step 2: Install Docker

If Docker is not installed, you can install it using the following commands:

sudo apt install apt-transport-https ca-certificates curl software-properties-common -y
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add -
echo "deb [arch=amd64] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list
sudo apt update
sudo apt install docker-ce -y

Start and enable Docker to run on boot:

sudo systemctl start docker
sudo systemctl enable docker

Step 3: Install Docker Compose

Install Docker Compose with the following command:

sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

Verify the installation:

docker-compose --version

Step 4: Clone the AWX Repository

Clone the Ansible AWX repository from GitHub:

git clone https://github.com/ansible/awx.git

Change to the AWX directory:

cd awx/installer

Step 5: Configure Inventory File

Edit the inventory file to configure the installation settings:

nano inventory

Set the following parameters as needed:

postgres_data_dir=/var/lib/pgsql/data
host_port=80
awx_port=80

Ensure you set the correct PostgreSQL user and password as well.

Step 6: Install AWX

Run the installation playbook using Ansible:

ansible-playbook -i inventory install.yml

This process will take a few minutes to complete.

Step 7: Access AWX Web Interface

Once the installation is complete, you can access the AWX web interface by navigating to http://your_server_ip in your web browser. The default admin username is admin, and the password will be displayed in the terminal after installation.

Step 8: Conclusion

You have successfully installed Ansible AWX on Debian 11, providing a powerful web interface for managing your Ansible tasks. This setup can greatly benefit from being hosted on a Windows VPS. For additional options, explore various VPS UK Windows solutions, including Windows Virtual Private Server Hosting and Windows VPS Hosting UK for optimal performance.