{% blocktrans %}The core BigBrother behaviour lives in BigBrotherConfig. These options handle activation, hostile lists, webhooks, and background schedulers. Adjust them from Django admin → BigBrother → BigBrotherConfig.{% endblocktrans %}
| {% translate "Field" %} | {% translate "Description" %} |
|---|---|
manual_main_corporation_override / manual_main_corporation_id |
{% translate "Optional override for primary corporation detection. When enabled, the configured corporation ID is used as the main corporation source." %} |
main_corporation_id / main_corporation |
{% translate "Derived main corporation snapshot used across checks and filters. Auto-populated from the first superuser character unless manual override is enabled." %} |
main_alliance_id / main_alliance |
{% translate "Alliance counterpart derived from the resolved main corporation. These fields remain read-only snapshots." %} |
is_active |
{% translate "Managed by the updater. Turns false if the corporation/alliance is not authorised." %} |
| {% translate "Field" %} | {% translate "Description" %} |
|---|---|
limit_to_main_corp |
{% translate "If enabled, compliance checks and dashboard visibility will be restricted to members of the primary corporation only. Use this if your Alliance Auth instance is dedicated to a single corporation but contains other alliance members." %} |
bb_guest_states |
{% translate "AllianceAuth states treated as guests. Recruiter-level users only see pilots in these states." %} |
bb_member_states |
{% translate "States that count as full members for BigBrother and CorpBrother checks." %} |
member_corporations / member_alliances |
{% translate "Comma-separated IDs that should be considered members even if they sit outside the primary corp/alliance." %} |
ignored_corporations |
{% translate "Corporation IDs excluded from CorpBrother dropdowns and compliance checks." %} |
| {% translate "Field" %} | {% translate "Description" %} |
|---|---|
hostile_alliances / hostile_corporations |
{% translate "Comma-separated IDs that flag alliances or corporations as hostile. Cards, mails, and transactions look here to colour results red." %} |
whitelist_alliances / whitelist_corporations |
{% translate "IDs that should never be flagged, even if they appear in default hostile data sets." %} |
consider_nullsec_hostile |
{% translate "If enabled, all systems in nullsec regions are treated as hostile for asset and clone checks." %} |
consider_all_structures_hostile |
{% translate "When enabled, any player-owned structure not in your whitelists is treated as a hostile location." %} |
consider_npc_stations_hostile |
{% translate "Treats all NPC stations as hostile locations for asset/clone checks." %} |
excluded_systems / excluded_stations |
{% translate "Comma-separated IDs of systems or stations that should be ignored by hostile checks." %} |
hostile_assets_ships_only |
{% translate "If enabled, only ship assets are evaluated when checking for hostile asset placements." %} |
| {% translate "Field" %} | {% translate "Description" %} |
|---|---|
alliance_blacklist_url |
{% translate "URL for your alliance-level blacklist tool, if applicable." %} |
external_blacklist_url |
{% translate "URL for an external or coalition-level blacklist." %} |
| {% translate "Field" %} | {% translate "Description" %} |
|---|---|
auto_import_contacts_enabled |
{% translate "When enabled, BigBrother will periodically import standings from aa-contacts and merge them into the member/hostile/whitelist lists." %} |
contacts_source_alliances / contacts_source_corporations |
{% translate "Alliances and Corporations whose aa-contacts standings should be imported. Positive standings become members; negative become hostile; neutral handling is controlled below." %} |
contacts_handle_neutrals |
{% translate "Controls how neutral (0) standings are treated: handle as hostile, whitelist/ignore, or do nothing." %} |
contacts_import_cache |
{% translate "Internal cache of imported IDs so removals from aa-contacts can be pruned without touching manually maintained lists." %} |
| {% translate "Field" %} | {% translate "Description" %} |
|---|---|
*_notify toggles |
{% translate "Individual checkboxes to enable/disable Discord alerts for: cyno changes, SP injections, hostile clones, assets, contacts, contracts, CT audits, AWOX kills, mails, and transactions." %} |
new_user_notify |
{% translate "If enabled, sends a full history digest when a user is first audited (can be very spammy)." %} |
ticket_notify_man / auto |
{% translate "Enable notifications when compliance tickets are closed manually or automatically." %} |
pingroleID / pingroleID2 |
{% translate "Discord role IDs to mention when selected message types fire. Use raw numeric IDs." %} |
pingrole1_messages / pingrole2_messages |
{% translate "Choose which MessageType entries ping each role." %} |
here_messages / everyone_messages |
{% translate "Message types that should ping @here or @everyone through the configured webhook." %} |
webhook_app_name |
{% translate "Name shown for Discord webhook messages sent by this app. Overrides the webhook default name when set." %} |
webhook / loawebhook / dailywebhook / optwebhook1-5 |
{% translate "Discord webhook destinations for core alerts, LoA notices, daily digests, and up to five optional channels." %} |
stats_webhook |
{% translate "Discord webhook used for recurring stats posts (when enabled)." %} |
| {% translate "Field" %} | {% translate "Description" %} |
|---|---|
show_market_transactions |
{% translate "Master toggle to show market escrow and market transaction events in reports." %} |
market_transactions_show_major_hubs |
{% translate "Flag transactions occurring in Jita, Amarr, Dodixie, Rens, or Hek." %} |
market_transactions_show_secondary_hubs |
{% translate "Flag transactions in secondary hubs like Oursulaert, Agil, or Perimeter." %} |
market_transactions_excluded_systems |
{% translate "Comma-separated system IDs to ignore for market transaction monitoring." %} |
market_transactions_threshold_alert / percent |
{% translate "Enable alerts only when buy/sell prices deviate from market averages by the specified percentage." %} |
market_transactions_price_method |
{% translate "Choose between Fuzzwork or Janice for price lookups." %} |
market_transactions_janice_api_key |
{% translate "Required API key if Janice is selected as the price source." %} |
market_transactions_fuzzwork_station_id |
{% translate "Reference station for Fuzzwork prices (defaults to Jita IV-4)." %} |
market_transactions_price_instant |
{% translate "Prefer immediate/instant prices over average or percentile prices (Fuzzwork only)." %} |
market_transactions_price_max_age |
{% translate "Maximum age (in days) for cached market prices before a refresh is triggered." %} |
| {% translate "Field" %} | {% translate "Description" %} |
|---|---|
character_scopes / corporation_scopes |
{% translate "Comma-separated scope requirements. Missing scopes surface in the Compliance card and related alerts." %} |
| {% translate "Field" %} | {% translate "Description" %} |
|---|---|
dailyschedule / optschedule1-5 |
{% translate "Celery beat schedules used for daily and optional webhook messages." %} |
stats_schedule |
{% translate "Celery beat schedule used for recurring stats posts." %} |
are_recurring_stats_active |
{% translate "Master switch for recurring stats posts." %} |
is_loa_active / is_paps_active |
{% translate "Toggle the integrated LoA and PAP modules. Restart AllianceAuth after changing." %} |
is_warmer_active |
{% translate "Enables the cache warmer that preloads contract/mail/transaction streams. Disable only if your gunicorn timeout in supervisor config is set to 0." %} |
are_daily_messages_active / are_opt_messages1-5_active |
{% translate "Master switches for daily and optional message delivery. Turn off to pause alerts without removing schedules or webhooks." %} |
update_stagger_seconds |
{% translate "The total time window across which user updates are performed." %} |
update_cache_ttl_hours |
{% translate "How long certain check results are cached before being refreshed. Such as Clone States." %} |
update_maintenance_window_start / end |
{% translate "Start and end times for the maintenance window where updating cached data is preferred." %} |
update_backlog_threshold / notify |
{% translate "Alert if more than this percentage of tasks from the previous run are still active." %} |
loa_max_logoff_days |
{% translate "Maximum days a user may stay logged off without an LoA before reminders escalate." %} |
clone_state_always_recheck |
{% translate "If enabled, characters with known skills proving Alpha/Omega state are re-checked every run, bypassing TTL. Disabling this improves performance for large fleets." %} |
{% blocktrans %}Fields not listed above are read-only helpers populated by automation. Leave them unchanged unless instructed by the maintainer.{% endblocktrans %}
{% endblock %}