Quickstart

What Happens Next (Automatically)

Once /setup completes, you don’t need to do anything else. WardForge works silently in the background:

Event	WardForge’s Response
Member joins with account < 24 h	Quarantine role applied immediately
Raid detected (multiple rapid joins)	Lock triggered; suspicious members flagged
Member posts a phishing link	Message deleted; member warned or banned
Member submits `/report` with a confirmed link	Instant Global Ban across the network
Admin deletes channels rapidly	Snapshot triggered; restore button sent to staff

Minimal Permission Set

After the initial setup, you can restrict WardForge’s permissions to:

Permission	Why it’s needed
Manage Roles	Apply/remove quarantine role
Manage Channels	Restore deleted channels from snapshots
Ban Members	Execute Global Ban when phishing is confirmed
Kick Members	Remove quarantined members who fail verification
View Channels	Monitor all channels for phishing links
Send Messages	Post alerts and embeds
Embed Links	Rich embed alerts
Read Message History	Scan recent messages on join

Administrator is only required during /setup to create the initial role/channel structure. You can remove it immediately after.

Docker Self-Hosting (Optional)

If you prefer to host WardForge yourself:

# 1. Clone the repository
git clone https://github.com/your-org/wardforge.git && cd wardforge

# 2. Configure environment
cp .env.example .env
nano .env   # Fill in DISCORD_TOKEN and DB_PASSWORD at minimum

# 3. Start all services
docker compose up -d

# 4. Check logs
docker compose logs -f guardian-bot

Set a strong REDIS_PASSWORD and DB_PASSWORD in your .env before starting. The default values in .env.example are placeholders only.

The only ports exposed to the internet are 80 and 443 (Nginx). Everything else — the bot, the dashboard, Redis, PostgreSQL — communicates on an isolated internal Docker network.

​Quickstart

​What Happens Next (Automatically)

​Minimal Permission Set

​Docker Self-Hosting (Optional)

What Happens Next (Automatically)

Minimal Permission Set

Docker Self-Hosting (Optional)