Self-hosted, Apache 2.0-licensed automation platform for Ansible, infrastructure-as-code, drift detection, and policy-as-code. A modernized fork of Ansible AWX with a Kubernetes-native control plane, native OIDC + WebAuthn, OpenTelemetry observability, and a declarative operator for GitOps workflows.

📚 Documentation · 🚀 Quick Start · ☸️ Kubernetes · 🤖 Operator · 📦 Releases

Forail Platform is a modern, open source alternative to Ansible Tower / Ansible Automation Platform (AAP) / AWX. It runs your Ansible playbooks at scale with role-based access control (RBAC), surveys, schedules, audit trails, and a distributed task engine — all on infrastructure you own.

If you have outgrown standalone ansible-playbook runs but do not want to lock yourself into a vendor SaaS or a Red Hat subscription, Forail is for you.

AWX is a great foundation but has accumulated legacy patterns over years of stewardship. Forail keeps the proven task engine, RBAC model, and inventory abstractions, while modernizing everything around them:

• Distributed task engine with Receptor mesh networking — execution nodes can sit behind NAT, run on-prem, or in air-gapped environments
• Dynamic surveys with per-job-template input forms, regex validation, conditional fields
• Schedules, workflows (DAG of jobs with conditional edges), notifications, callbacks

• RBAC with custom roles, team membership, organization scoping
• SSO: LDAP, SAML 2.0, OIDC (Keycloak, Authentik, Auth0, Okta, Azure AD), social auth
• WebAuthn / passkeys for hardware-key second factor
• Audit trail — every state change recorded with actor, resource, before/after diff
• Self-service portal — end users request access via approval workflows

• Helm chart — helm install forail oci://ghcr.io/forail-platform/forail-helm
• Operator v1.0.0 with 9 CRDs (Organization, Team, Project, Inventory, Credential, JobTemplate, Schedule, Workflow, ForailInstance) for GitOps-style management
• Multi-cluster — single operator reconciles multiple Forail backends via ForailInstance CR
• OLM bundle — install via OperatorHub or kubectl operator install

• OpenTelemetry traces from API → task dispatcher → execution worker, all correlated by trace ID
• Prometheus metrics for job throughput, queue depth, worker utilization
• Structured logs to stdout, OpenTelemetry log pipeline, or Loki
• Drift detection — periodic compare of declared inventory vs. actual cloud/host state, alerts on divergence

• OPA (Open Policy Agent) sidecar — enforce policies on job runs (no execution against prod after-hours, no --check=no, mandatory tags, etc.)
• IaC scanning — Terraform, CloudFormation, Pulumi static analysis with Checkov integration
• Event-driven automation — webhook receivers trigger jobs from external systems

⚠️The AI Assistant is under active development and is not yet production-ready. It is shipped as a preview for early feedback. APIs, models, and capabilities may change between releases. Do not depend on it for critical workflows yet.

• Fully self-hosted preview — runs Ollama + ChromaDB embedded in a single container
• Default model: gemma3:1b (small, fast, 2 GB pod). Swap to any Ollama-compatible model
• No data leaves your cluster — designed for privacy-first operation
• Track progress and known limitations in forail-assistant

git clone https://github.com/forail-platform/forail-devops.git
cd forail-devops
cp .env.example .env
docker compose up -d
# UI on https://localhost (admin / changeme — change it!)

kubectl create namespace forail
helm install forail oci://ghcr.io/forail-platform/forail-helm --version 1.0.0 -n forail
# Or clone https://github.com/forail-platform/forail-helm and `helm install forail ./`

Images are on the public GitHub Container Registry — no pull secret required.

helm install forail-operator oci://ghcr.io/forail-platform/forail-operator-helm \
-n forail-operator --create-namespace \
--set forail.token=<your-forail-PAT># Then commit Organization/Project/JobTemplate CRs to git

See forail-platform.github.io/docs/operator-v1.html for full operator usage.

Full docs are at forail-platform.github.io:

• Architecture Overview
• Docker Deployment Guide
• Kubernetes Deployment
• Operator v1.0.0 (Multi-cluster, Workflow DAG, OLM)
• User Handbook
• Administrator Handbook
• API Reference
• Release Notes — v2026.05.0

Yes. Apache License 2.0. No paid tier, no enterprise lock-in, no telemetry phone-home. The container images on ghcr.io/forail-platform are public and unlimited.

Forail keeps the proven AWX task engine and RBAC model, but rewrites everything around them on a modern stack (Python 3.12, Django 4.2, React 18, TypeScript), adds first-class Kubernetes support via a native operator with 9 CRDs, integrates OpenTelemetry for observability, ships an OPA sidecar for policy enforcement, and bundles an optional self-hosted AI assistant. See the comparison table above.

AAP is Red Hat's commercial offering with paid support, certified content collections, and proprietary features (e.g., automation analytics SaaS). Forail has no commercial tier — you self-host everything. Forail is closer to the AWX experience but more modern; if you need Red Hat support contracts, AAP is your choice. If you want full sovereignty and a modern codebase, Forail is.

Forail's data model is largely compatible with AWX (since it's a fork). A migration tool is on the Phase B roadmap. In the meantime, the operator's GitOps approach lets you re-declare your AWX resources as CRs and reconcile them into Forail.

• Single-machine (Docker Compose): 4 GB RAM, 2 vCPU, 20 GB disk
• Production (Kubernetes): 3 worker nodes, 8 GB RAM each, plus Postgres + Redis backing services
• Reference dev cluster: forail-dev-cluster is a 3-server + 4-worker k3s Vagrant setup, ~28 GB RAM total

Not yet — it is under active development as of the latest release. The forail-assistant is shipped as a preview to gather early feedback; APIs and capabilities may change. Do not use it for production-critical workflows.

No. The optional forail-assistant (preview) runs Ollama and ChromaDB embedded in a single container. Models run locally on CPU or GPU. No outbound calls to OpenAI, Anthropic, or any third party — privacy-first by design.

Each repository has a SECURITY.md. Email security issues privately to office@krletron.xyz. Public CVE process for confirmed vulnerabilities.

Founder and lead maintainer: Krstan Vjestica. Contributions welcome — see CONTRIBUTING.md.

We welcome contributions. Read the centralized contributing guide for git workflow, commit conventions, and PR process.

For bug reports: open an issue on the relevant repository. For security issues: email office@krletron.xyz (see SECURITY.md).

Forail is a modernized fork of Ansible AWX (Apache License 2.0), originally developed by Red Hat and the Ansible community. Full attribution is preserved in forail-backend/NOTICE.

All Forail Platform repositories are licensed under the Apache License, Version 2.0.