The Settings page is where you manage your account, security controls, notification preferences, theme options, and selected system-level behavior. It is one of the most important pages for day-to-day Cockpit administration.
When to Use This
- You want a quick explanation of what lives in Settings.
- You need to update account details such as name, avatar, username, or password.
- You want to review 2FA, notifications, theme controls, or analytics-related settings.
- You are onboarding another admin and want a safe page-tour article.
Main Sections You May See
The Settings page commonly includes these sections:
- Account for name, avatar, username, and password changes
- Security Settings for enabling or disabling 2FA
- Notifications for configuration-related preferences and, for owners, endpoint details
- Theme for tab configuration, accent color, and background options when branding allows it
- System Settings for panel-wide features such as visitor analytics and dashboard limits
How to Use the Page
- Open Settings from the sidebar.
- Start with Account if you need to update personal login details.
- Move to Security Settings if you want to review or set up 2FA.
- Review Notifications and endpoint-related items if you want to control how the panel behaves for your account.
- If theme changes are allowed by branding, use the Theme area for color or visual adjustments.
- Use System Settings when you need to adjust analytics preferences such as dashboard window size, chart limits, or retention.
Expected Result
After using the Settings page, your account and panel preferences should reflect the changes you intentionally saved, while the rest of the panel continues to operate normally.
What Each Area Is Best For
- Account: personal identity and login changes
- Security: strengthening access with 2FA
- Notifications: deciding what account-level information is shown or editable
- Theme: personalizing visual behavior where branding allows it
- System Settings: shaping how visitor analytics and dashboard summaries behave
Common Mistakes
- Changing too many things at once: Save one area at a time so it is easy to confirm what changed.
- Forgetting 2FA state: Before enabling or disabling it, make sure the operator understands how they will log in next time.
- Assuming theme options are always visible: Branding rules can hide some visual settings on purpose.
- Ignoring analytics settings: Dashboard history, chart limits, and retention are shaped here, so changes affect how data appears later.
Example Use Cases
- New owner setup: After first login, the owner updates their name, username, password, and 2FA settings before inviting staff.
- Analytics tuning: The admin adjusts dashboard window and retention settings so charts better reflect real usage patterns.
- Visual cleanup: A reseller changes accent color and allowed theme options so the panel better matches their brand style.
Related Articles
- First Login After Installing Cockpit
- Dashboard Tour
- How to Set Up 2FA
- How to Change Account Details