SculptOps/Docs
← Back to site

Introduction

SculptOps is a modern, self-hostable web interface for Ansible. Run playbooks, manage inventories, and automate your infrastructure from your browser.

What is SculptOps?

SculptOps gives your team a visual interface for everything Ansible-related — without losing the power or flexibility of the CLI. It runs as a Docker container alongside your existing infrastructure and connects to your servers via SSH, the same way Ansible does natively.

It is fully open source under the AGPL v3 license. You can self-host it for free, forever, with no limitations.

Key features

  • Playbook editor — Monaco-based editor with YAML syntax highlighting and version history.
  • Inventory manager — Groups, hosts, and variable overrides. Import/export INI or YAML.
  • Real-time logs — Live execution output streamed via SSE, color-coded by level.
  • Workflows — Chain playbooks into multi-step pipelines with conditional branching.
  • Schedules — Cron-based automation with next-run previews.
  • Webhooks — HTTP triggers from any CI/CD or monitoring system.
  • RBAC — Organizations with admin, member, and viewer roles.
  • Vault passwords — Encrypted storage of Ansible vault credentials.
  • Audit log — Full history of who ran what, and when.

Architecture overview

SculptOps is a Next.js application backed by a PostgreSQL database. When you run a playbook, the server spawns a short-lived Docker container that executes ansible-playbook and streams the output back to your browser in real time.

text
Browser  ──→  Next.js app  ──→  PostgreSQL
                    │
                    └──→  Docker (ephemeral)
                               │
                               └──→  ansible-playbook  ──→  SSH  ──→  Servers
Note
SculptOps does not install an agent on your servers. It connects via SSH exactly as the Ansible CLI would — using your existing SSH keys and inventory.

Quick start

The fastest way to get started is with Docker Compose:

bash
git clone https://github.com/refacto-eu/sculptops
cd sculptops
cp .env.example .env
docker compose up -d

For a full walkthrough, see the Installation guide.

Requirements

  • Docker 24+ and Docker Compose v2
  • PostgreSQL 15+ (included in the Compose file)
  • Linux, macOS, or Windows (via WSL2)
Next
Installation