Getting Started

Getting Started with AuthForge

This guide walks through launching AuthForge locally via Docker Compose or native Maven execution.

---

Prerequisites

• Java 21+ (Eclipse Temurin, GraalVM, or OpenJDK)
• Maven 3.9+
• Docker & Docker Compose (for automated PostgreSQL, backend, frontend, and MailHog orchestration)

---

1. Quickstart via Docker Compose (Fastest)

Clone the repository and spin up the complete identity infrastructure with one command:

git clone https://github.com/FrodyGr/authforge.git
cd authforge

# Launch PostgreSQL, Spring Boot Backend, Vanilla Web UI, and MailHog
docker-compose up -d --build

Service Map

Service	Endpoint	Credentials / Purpose
Frontend Web UI	http://localhost:4000	User registration, login dashboard, admin panel
Backend REST API	http://localhost:8080	Swagger / OpenAPI endpoints
MailHog Web Mailbox	http://localhost:8025	Inspect outgoing verification & reset emails
PostgreSQL Database	localhost:5432	DB: authforge, User: authforge, Pass: authforge

---

2. Running the Backend Locally

If running against a local PostgreSQL instance:

cd backend
./mvnw clean spring-boot:run

The server binds to port 8080 by default. Swagger documentation is available at http://localhost:8080/swagger-ui.html.