Tip

Check out the repository on GitHub

Check out the demo at: demo.webui.ansibleguy.net | Login: User demo, Password Ansible1337

Warning

DISCLAIMER: This is an unofficial community project! Do not confuse it with the vanilla Ansible product!

Warning

This project still in early development! DO NOT USE IN PRODUCTION!

2 - Installation

Ansible

See the documentation on how to install Ansible.

Make sure to read the Ansible best-practices on how to use Ansible!


Demo

Check out the demo at: demo.webui.ansibleguy.net

Login: User demo, Password Ansible1337


Install

Requires Python >=3.10

python3 -m pip install ansibleguy-webui

Using docker:

docker image pull ansible0guy/webui:latest

Start

TLDR:

cd $PLAYBOOK_DIR
python3 -m ansibleguy-webui

Using docker:

docker run -d --name ansible-webui --publish 127.0.0.1:8000:8000 ansible0guy/webui:latest

Details:

See: Usage - Run

Now you can open the Ansible-WebUI in your browser: http://localhost:8000


Proxy

You can find a nginx config example here: Nginx config example


Ansible Role

You can find an Ansible Role to install the app on Debian here: ansibleguy.sw_ansible_webui


Service

You might want to create a service-user:

sudo useradd ansible-webui --shell /usr/sbin/nologin --create-home --home-dir /home/ansible-webui

You can find a service config example here: Systemd config example

Enabling & starting the service:

systemctl enable ansible-webui.service
systemctl start ansible-webui.service

For production usage you should use a proxy like nginx in from of the Ansible-WebUI webservice!