Forge is a modern, modular monolith platform built for DevOps automation. It is designed to act as your ultimate local-first DevOps workstation, seamlessly orchestrating workflows, Docker containers, git operations, and continuous integration pipelines—all running entirely on your local machine or self-hosted server.
Forge prioritizes a local-first approach: source code, SSH keys, Docker daemons, and build artifacts never leave your control unless explicitly configured.
- Workspace Management: Group your repositories intelligently into logical workspaces.
- Automation & Workflows: Define, schedule, and execute complex workflows via the built-in Automation Engine and Quartz Scheduler.
- Docker Integration: Direct integration with your local Docker daemon to build, run, and view logs of containers.
- Git & Build Tooling: Native detection and execution capabilities for Maven, Gradle, and Git.
- Event-Driven Architecture: Asynchronous event streaming powered by Apache Kafka for observability, metrics, and audit logging.
- Modular Monolith Design: Clean architecture adhering to Ports and Adapters, ensuring extreme decoupling between domain logic and infrastructure.
The backend uses a strict layered architecture pattern to keep domain logic pure:
bootstrap: Application entrypoint and dependency wiring.api: REST controllers and WebSocket handlers.application: Application services and use-case orchestration.core: Pure domain contracts and entities.infrastructure: Adapters for persistence (PostgreSQL), scheduling, and external APIs.- Plugins: Pluggable modules for Docker, Git, Build, and Event Streaming.
See the ARCHITECTURE.md for detailed runtime flows and diagrams.
- Java 21+
- Node.js 22+
- Docker & Docker Compose
The fastest way to get started is by spinning up the full platform using Docker Compose.
docker compose up -dNavigate to http://localhost:3000 to view the Forge Dashboard.
Backend (Spring Boot)
cd backend
./gradlew :bootstrap:bootRunNote: Ensure PostgreSQL and Kafka are running via docker-compose before starting the backend natively.
Frontend (React + Vite)
cd frontend
npm install
npm run devForge is actively developed across distinct phases. From the foundational backend skeleton to advanced Kubernetes plugins, check out our progress in ROADMAP.md.
We welcome community contributions! Please review our Contributing Guidelines to understand our coding standards, branch naming conventions, and Pull Request process.
If you discover a security vulnerability, please refer to our Security Policy for responsible disclosure instructions.
Forge is open-source software licensed under the MIT License.