Christian Krakau-Louis
4.2 KiB
Settings
This guide covers the various settings and configuration options available in DMARQ.
General Settings
User Profile
To manage your user profile:
- Click on your username in the top-right corner
- Select Profile Settings
- Here you can:
- Update your name and email address
- Change your password
- Set your timezone and date format preferences
- Configure UI theme preferences (light/dark mode)
System Settings
System-wide settings are available to administrators:
- Navigate to Settings > System
- Configure the following options:
- Instance Name: Custom name for your DMARQ instance
- Logo: Upload a custom logo for branding
- Session Timeout: How long before inactive users are logged out
- Default Language: Set the default interface language
Notification Settings
Apprise Notifications
Configure where DMARQ sends notifications:
- Navigate to Settings.
- Open Notifications.
- Enable notifications.
- Add one Apprise target URL per line.
- Save and use Send Test to verify delivery.
Target URLs are redacted after saving so credentials are not exposed through the settings API or page reloads.
Alert Thresholds
Set thresholds for when alerts are triggered:
- Navigate to Settings > Notifications > Thresholds
- Configure thresholds for:
- Compliance Rate Drop: Alert when compliance falls below a threshold
- New Sending Sources: Alert when new IPs/servers send email as your domain
- Authentication Failures: Alert when failures exceed a certain number
- Report Processing Issues: Alert on report processing errors
Integration Notifications
Apprise supports email, Slack, Teams, Discord, generic webhooks, and many other targets through the same notification field. Add each destination on a separate line.
API Access
DMARQ provides an API for integration with other systems:
- Navigate to Settings > API Access
- Here you can:
- Generate API keys
- View and revoke existing keys
- Set permissions and access levels for each key
- View API usage statistics
Integrations
Cloudflare Integration
If you use Cloudflare for DNS management:
- Navigate to Settings > Integrations > Cloudflare
- Configure:
- API Token: Your Cloudflare API token
- Zone ID: The Cloudflare Zone ID for your domain
- Permissions: What actions DMARQ can take on your DNS records
Other Integrations
DMARQ supports additional integrations:
- Navigate to Settings > Integrations
- Select the integration you wish to configure
- Follow the specific setup instructions for that integration
Backup and Data Management
Data Retention
Configure how long DMARQ keeps data:
- Navigate to Settings > Data Management
- Configure retention periods for:
- Aggregate Reports: How long to keep aggregate report data
- Forensic Reports: How long to keep forensic report data
- Activity Logs: How long to keep system activity logs
Backup Configuration
Set up automated backups:
- Navigate to Settings > Data Management > Backups
- Configure:
- Backup Schedule: How often to create backups
- Backup Location: Where to store backups (local, S3, etc.)
- Retention: How many backups to keep
Data Export
Configure scheduled data exports:
- Navigate to Settings > Data Management > Exports
- Configure scheduled exports to CSV or JSON format
- Set delivery methods (download, email, FTP, etc.)
System Logs
View and manage system logs:
- Navigate to Settings > Logs
- Filter logs by:
- Log Level: Error, Warning, Info, Debug
- Component: API, Parser, IMAP, Authentication, etc.
- Time Range: When the logs were generated
- Download logs for external analysis if needed
Advanced Settings
Advanced configuration options (administrators only):
- Navigate to Settings > Advanced
- Configure:
- Database Connection: Change database settings
- Worker Configuration: Configure background processing settings
- Caching: Adjust cache settings for performance
- Debug Mode: Enable additional logging for troubleshooting