# Manage Settings

All configuration in **FirewallX** is managed from the **web dashboard**.\
There are **no public slash-commands for editing settings**.

***

## Access the Dashboard

1. Open the FirewallX dashboard and sign in with Discord.
2. Pick the **server (guild)** you want to configure from the server list.
3. You must have **Administrator** on that server to change settings.

> If a server doesn’t appear, make sure the bot is invited to it and the OAuth permission **“Manage Server”** was granted during login.

***

## Global Controls (per-guild)

From the server home in the dashboard you can:

* **Enable/Disable modules** you need.
* Choose a **default log channel** or per-module log channels.
* Select **interface language** (Arabic / English) and **RTL/LTR** layout.
* Manage **Premium** (trial, plan, and premium-only toggles).

Changes are saved to the database (MongoDB) and apply immediately.

***

## Modules & What You Can Configure

### Anti-Nuke

Protects against mass destructive actions.

* **Triggers**: rapid bans/kicks, role deletions, channel deletions, dangerous guild edits.
* **Thresholds**: maximum actions allowed within a time window before protection activates.
* **Punishment**: remove roles / timeout / kick / ban for the attacker account.
* **Safelists**: exempt trusted **users/roles** (e.g., other security bots or staff).
* **Logs**: send detailed events to the selected log channel.

> See the Anti-Nuke section for details on triggers, limits, and punishments.

### Anti-Raid

Mitigates join floods and coordinated raids.

* **Join-rate limit**: number of joins allowed per time window.
* **Auto-lock**: temporarily lock new joins when a raid is detected.
* **Verification gate**: optionally require passing the verification step before access.
* **Logs**: detection and actions are recorded.

### Moderation (Spam/Swear/Filters)

Automated moderation helpers.

* **Spam sensitivity**: repeated messages, mentions, or links.
* **Profanity / word filters**: optional rulesets and custom keywords.
* **Escalation**: warn → timeout → kick/ban (configurable).
* **Whitelists**: exempt roles/channels (e.g., staff channels).
* **Logs**: all actions recorded.

### Verification

Controls how members verify before interacting.

* **Method**: button/captcha flow (as configured in your dashboard).
* **Verified role**: role granted after successful verification.
* **Message & retry limits**: customize the prompt and how many attempts are allowed.
* **Logs**: attempts and results are recorded.

### Tickets

Support ticket system for your community.

* **Categories / panels**: create open buttons per category.
* **Staff roles**: who can see and reply.
* **Auto-close**: close inactive tickets after a duration.
* **Transcripts**: save transcripts to a channel (and files if enabled).

### Threat-Intelligence (TI)

Live checks against unsafe patterns.

* **Policies**: choose Strict / Balanced / Custom.
* **Feeds**: `badDomains`, suspicious name patterns, link detection, and custom entries.
* **Link Whitelist**: allow specific domains/URLs to bypass link blocks.
* **Custom Policy**: add your own TI rules per guild.
* **Logs**: any block/allow decision is logged.

### Whitelists (Access)

Fine-grained exemptions.

* **Users / Roles / Channels**: exempt from certain checks or punishments.
* **Use cases**: allow a bot role to manage channels, or allow a staff channel to post external links.

***

## Logs & Premium (Deep Audit Logs)

### Standard Logs

* Every module can post **rich logs** to its assigned channel.
* Logs include actor, target, action, reason (when available), and contextual fields.

### Deep Audit Logs (Premium)

* **Hash-chained** per guild (SHA-256 chain).
* Each event stores a **`requestId`** and the previous event’s hash to ensure log integrity.
* Tamper-evident: any modification breaks the chain.
* Designed for long-term auditing and dispute resolution.

> Premium can be started with a 14-day free trial. Plans are per guild.

***

## Saving & Applying Changes

* **Save** in each section when you modify settings; changes apply instantly.
* If logs don’t appear, confirm:
  * The bot can **see and send messages** in the selected log channel.
  * The **correct channel** is selected per module (not a single static channel).
  * No role hierarchy blocks the bot from moderating.

***

## Troubleshooting

* **Settings not showing up?** Hard refresh the dashboard and reselect the server.
* **Can’t change settings?** Ensure your Discord account has **Administrator** on that server.
* **Module doesn’t trigger?** Check its **toggle**, **threshold**, and **whitelists**.
* **Link blocked by mistake?** Add it to **Threat-Intelligence → Link Whitelist**.

***

## Summary

Use the **dashboard** to manage everything: enable modules, tune thresholds, set punishments, pick log channels, build whitelists, and—if you’re on Premium—record an immutable **Deep Audit Log** for your guild.
