Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/flagForgeCTF/flagForge/llms.txt

Use this file to discover all available pages before exploring further.

FlagForge is a beginner-friendly, open-source CTF (Capture The Flag) platform that makes it easy to host, manage, and participate in cybersecurity challenges. Whether you’re a player looking to sharpen your skills or an organizer running a competition, FlagForge provides the tools you need — from a challenge library with hints to a real-time leaderboard and a dynamic per-user flag system that prevents flag sharing.

Quickstart

Set up FlagForge and start solving your first challenge in minutes.

Core Features

Explore challenges, flag submission, dynamic flags, leaderboards, and badges.

Admin Guide

Manage challenges, users, and badges from the admin dashboard.

API Reference

Integrate with FlagForge programmatically using the REST API.

What is FlagForge?

FlagForge is a full-stack CTF platform built with Next.js, TypeScript, and MongoDB. It’s designed to be approachable for beginners while providing the depth that experienced players and organizers expect.

Dynamic Flags

Per-user unique flags prevent sharing and ensure fair scoring, with GUID, team hash, and leet-speak variants.

Real-Time Leaderboard

Track scores and rank across all participants as challenges are solved.

Badge System

Earn and display badges for achievements, roles, and milestones.

Hints

Configurable per-challenge hints with adjustable point deductions.

Time-Limited Challenges

Set expiry dates on challenges to create event-style competitions.

Discord Integration

Automatic notifications to your Discord server when new challenges are released.

Get started

1

Create your account

Sign up at flagforgectf.com using Google OAuth or visit a self-hosted instance. Your profile tracks your score, solved challenges, and earned badges.
2

Browse challenges

Head to the Problems page to see all available challenges. Filter by category — Web, Crypto, Forensics, Pwn, and more — to find challenges that match your skill level.
3

Solve and submit your flag

Open a challenge, read the description, and download any attached files. Once you find the flag, enter it in the submission box. Flags follow the format flag{...}.
4

Track your progress

Watch your score update on the Leaderboard and check your Profile to see solved challenges, earned badges, and your ranking among other players.

Self-hosting

FlagForge is fully open-source under the GPL-3.0 license. You can deploy your own instance to run private CTF events for your organization, club, or classroom.

Deployment guide

Step-by-step instructions for setting up your own FlagForge instance.

Environment variables

Configure authentication, database, and integrations for your deployment.

Build docs developers (and LLMs) love