Settings Overview

Manage your Controlinfra account, AI providers, and preferences.

Accessing Settings

Click the Settings icon in the bottom navigation to access your account settings.

Account Settings

Profile Information

View your account details:

Field	Description
Username	Your GitHub username
Email	Email associated with GitHub
Avatar	Your GitHub profile picture
Member Since	Account creation date

GitHub Connection

Your GitHub connection status and permissions:

• Connected: Your GitHub account is linked
• Permissions: Repositories you've granted access to
• Re-authorize: Update permissions or reconnect

AI Provider Configuration

Provider Selection

Choose your AI provider:

○ Anthropic Claude (Recommended)
○ OpenAI GPT-4
○ None (Disable AI analysis)

API Key Management

Action	Description
Add Key	Enter your API key
Update Key	Replace existing key
Remove Key	Delete key and disable AI
Test Key	Verify key is valid

Your API key is:

• Encrypted at rest
• Never displayed after saving
• Only used for drift analysis

TIP

See AI Provider Setup for detailed instructions.

Quota & Usage

Cloud Runner Quota

If using Controlinfra's cloud runners:

Monthly Scans: 45 / 100 used
Resets: January 1, 2025

AI Usage

AI costs are billed directly to your provider account. Monitor usage in:

• Anthropic Console
• OpenAI Platform

Runner Management

Cloud Runner

• Status: Enabled/Disabled
• Quota: Monthly scan limit

Self-Hosted Runners

Manage your self-hosted runners:

Runner	Status	Labels	Last Seen
prod-runner	🟢 Online	production, aws	2 min ago
staging-runner	🟢 Online	staging	5 min ago
backup-runner	🔴 Offline	backup	3 hours ago

Actions:

• Add Runner: Register a new self-hosted runner
• Edit Labels: Update runner labels
• Regenerate Token: Create new authentication token
• Remove Runner: Delete runner registration

TIP

See Self-Hosted Runners for setup instructions.

Notification Preferences

Email Notifications

Configure when to receive emails:

Notification	Options
Scan Complete	All / Drift Only / Never
Critical Drift	Immediately / Daily Digest / Never
Weekly Summary	Enabled / Disabled
Scan Failures	All / Never

In-App Notifications

• Show Toast Notifications: Enable/disable popup notifications
• Sound: Enable/disable notification sounds

Theme Settings

Appearance

○ Light Mode
○ Dark Mode
○ System (follow OS preference)

Controlinfra supports both light and dark modes with a carefully designed color palette.

Data & Privacy

Export Data

Download your data:

• Repositories: List of connected repositories
• Scan History: All scan results and drift data
• Settings: Your configuration (excluding secrets)

Delete Account

DANGER

Deleting your account will:

• Remove all connected repositories
• Delete all scan history
• Remove all drift analysis data
• Revoke GitHub integration

This action cannot be undone.

To delete:

1. Go to Settings → Danger Zone
2. Click Delete Account
3. Type your username to confirm
4. Click Permanently Delete

API Access

Personal Access Tokens

Generate tokens for API access:

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://api.controlinfra.com/v1/repositories

Action	Description
Generate Token	Create new API token
List Tokens	View active tokens
Revoke Token	Delete a token

Token Scopes

Scope	Permissions
read:repositories	View repositories
write:repositories	Add/edit repositories
read:scans	View scan results
write:scans	Trigger scans
admin	Full access

Integrations

GitHub

• Status: Connected
• Permissions: repo, read:user
• Reconnect: Update OAuth permissions

Slack (Coming Soon)

Get drift alerts in Slack:

• Select channel for notifications
• Configure alert types

Webhooks (Coming Soon)

Send scan results to your systems:

• Custom webhook URL
• Event filtering
• Payload customization

Support

Help Resources

• Documentation: You're here!
• FAQ: Common questions and answers
• Status Page: Service status and incidents

Contact Support

• Email: support@controlinfra.com
• GitHub Issues: Report bugs and feature requests

Settings Quick Reference

Setting	Location	Description
AI Provider	Settings → AI	Configure Claude/OpenAI
Runners	Settings → Runners	Manage self-hosted runners
Notifications	Settings → Notifications	Email preferences
Theme	Settings → Appearance	Light/dark mode
API Tokens	Settings → API	Generate access tokens
Account	Settings → Account	Profile and deletion

Next Steps

• Configure AI Provider
• Set Up Self-Hosted Runners
• Connect Your First Repository