Ansible UI

A self-hosted web UI for managing Ansible projects, inventories, credentials, templates, and task runs.

Prerequisites

• Node.js 20+
• npm 10+
• PostgreSQL (recommended 14+)
• Git
• Ansible (ansible-playbook must be available in PATH)
• sshpass (required only if you use password-based SSH auth in tasks)

Installation

1. Clone and enter the project:

   git clone https://github.com/frozendark01/Ansible-UI.git
   cd Ansible-Hub

2. Install dependencies:

   npm install

3. Create a PostgreSQL database and set environment variables:

   cp .env.example .env 2>/dev/null || touch .env

   Add at least:

   DATABASE_URL=postgresql://USER:PASSWORD@HOST:5432/DB_NAME
   PORT=5000

4. Push the schema to your database:

   npm run db:push

5. Start the development server:

   npm run dev

   App runs at http://localhost:5000 by default.

Production

Build and run:

npm run build
npm start

Useful Commands

• npm run check — TypeScript type check
• npm run db:push — apply schema changes to PostgreSQL
• npm run build — build client + server