# AWX Installieren

Hier eine erprobte Schritt-für-Schritt-Anleitung zur Installation der Open-Source-Version von AWX (aktuell v17.1.0) mit Docker Compose – ganz ohne Kubernetes, offiziell zwar nur für Tests gedacht, in der Praxis aber voll funktionsfähig.

---

## 1. System-Abhängigkeiten installieren

**Unter Ubuntu/Debian**

```bash
sudo apt update
sudo apt install -y git gcc g++ python3-pip ansible curl
pip3 install docker docker-compose

```

([mpolinowski.github.io](https://mpolinowski.github.io/docs/DevOps/Ansible/2021-04-28-ansible-tower-rhel/2021-04-28 "Installing Ansible Tower (AWX in Docker) on RHEL8 | Mike Polinowski"), [docs.zpesystems.com](https://docs.zpesystems.com/guides/docs/install-awx-171-on-nodegrid-os "Install AWX 17.1 on Nodegrid OS"))

**Unter RHEL/CentOS 8**

```bash
sudo dnf install -y git gcc gcc-c++ python3-pip ansible curl
sudo alternatives --set python /usr/bin/python3
pip3 install docker docker-compose

```

([mpolinowski.github.io](https://mpolinowski.github.io/docs/DevOps/Ansible/2021-04-28-ansible-tower-rhel/2021-04-28 "Installing Ansible Tower (AWX in Docker) on RHEL8 | Mike Polinowski"), [docs.zpesystems.com](https://docs.zpesystems.com/guides/docs/install-awx-171-on-nodegrid-os "Install AWX 17.1 on Nodegrid OS"))

> Damit sind Docker, Docker Compose, Ansible und die nötigen Build-Tools auf dem Host.

---

## 2. AWX-Quellcode klonen & zum Installer wechseln

```bash
git clone -b 17.1.0 https://github.com/ansible/awx.git
cd awx/installer

```

([docs.zpesystems.com](https://docs.zpesystems.com/guides/docs/install-awx-171-on-nodegrid-os "Install AWX 17.1 on Nodegrid OS"), [mpolinowski.github.io](https://mpolinowski.github.io/docs/DevOps/Ansible/2021-04-28-ansible-tower-rhel/2021-04-28 "Installing Ansible Tower (AWX in Docker) on RHEL8 | Mike Polinowski"))

---

## 3. Secret-Key erzeugen

Der Installer benötigt einen 30-stelligen Schlüssel für die interne Verschlüsselung.  
Wahlweise mit OpenSSL:

```bash
openssl rand -base64 30 > secret_key.txt

```

([mpolinowski.github.io](https://mpolinowski.github.io/docs/DevOps/Ansible/2021-04-28-ansible-tower-rhel/2021-04-28 "Installing Ansible Tower (AWX in Docker) on RHEL8 | Mike Polinowski"))

Oder mit pwgen:

```bash
pwgen -N1 -s30 > secret_key.txt

```

([docs.zpesystems.com](https://docs.zpesystems.com/guides/docs/install-awx-171-on-nodegrid-os "Install AWX 17.1 on Nodegrid OS"))

---

## 4. Inventardatei anpassen

Öffne `installer/inventory` in deinem Lieblings-Editor und setze mindestens diese Werte im Block `[all:vars]`:

```ini
# Web-Zugriff
host_port=80
host_port_ssl=443

# Admin-Account
admin_user=admin
admin_password=MeinSicheresPasswort

# Secret Key (aus secret_key.txt)
secret_key=<Inhalt von secret_key.txt>

# (Optional) Pfade für persistente Daten
postgres_data_dir="/opt/awx/pgdocker"
project_data_dir="/opt/awx/projects"
docker_compose_dir="/opt/awx/awxcompose"

```

([docs.zpesystems.com](https://docs.zpesystems.com/guides/docs/install-awx-171-on-nodegrid-os "Install AWX 17.1 on Nodegrid OS"), [mpolinowski.github.io](https://mpolinowski.github.io/docs/DevOps/Ansible/2021-04-28-ansible-tower-rhel/2021-04-28 "Installing Ansible Tower (AWX in Docker) on RHEL8 | Mike Polinowski"))

> Achte darauf, dass die Verzeichnisse existieren und Docker-Prozesse darauf schreiben dürfen (z.B. `sudo mkdir -p /opt/awx/{pgdocker,projects,awxcompose}`).

---

## 5. Installation per Ansible-Playbook starten

```bash
ansible-playbook -i inventory install.yml

```

([docs.zpesystems.com](https://docs.zpesystems.com/guides/docs/install-awx-171-on-nodegrid-os "Install AWX 17.1 on Nodegrid OS"), [mpolinowski.github.io](https://mpolinowski.github.io/docs/DevOps/Ansible/2021-04-28-ansible-tower-rhel/2021-04-28 "Installing Ansible Tower (AWX in Docker) on RHEL8 | Mike Polinowski"))

Der Playbook-Lauf erzeugt via Docker Compose Container für PostgreSQL, Redis, das AWX-Web-UI und den Task-Worker.

---

## 6. Kontrolle &amp; Erster Zugriff

1. **Status prüfen**
    
    ```bash
    docker ps
    
    ```
2. **Installations-Logs beobachten**
    
    ```bash
    docker logs -f awx_task
    
    ```
    
    Warte, bis dort die Datenbank-Migrations-Tasks erfolgreich durchgelaufen sind.
3. **Web-UI öffnen**  
    Rufe im Browser auf:
    
    ```
    http://<Deine-Server-IP>:80
    
    ```
    
    Login mit `admin / MeinSicheresPasswort`.  
    ([docs.zpesystems.com](https://docs.zpesystems.com/guides/docs/install-awx-171-on-nodegrid-os "Install AWX 17.1 on Nodegrid OS"), [mpolinowski.github.io](https://mpolinowski.github.io/docs/DevOps/Ansible/2021-04-28-ansible-tower-rhel/2021-04-28 "Installing Ansible Tower (AWX in Docker) on RHEL8 | Mike Polinowski"))

---

**Fertig!** Du hast nun AWX 17.1.0 vollständig in Docker-Containern laufen, ganz ohne Kubernetes.