Settings

Manage your account profile, team members, notification preferences, and security settings in Orkestia.

What are Settings?

The Settings page allows you to configure your account, manage your team, control how you receive notifications, and handle security preferences. Settings are organized into sections based on functionality.

Accessing Settings

To access Settings:

1. Click your profile avatar in the top-right corner
2. Select Settings from the dropdown menu
3. Or navigate directly to /settings in your browser

Settings Sections

Navigation Structure

Settings
├── General (Profile & Preferences)
│   ├── Profile Information
│   │   ├── Display Name (editable)
│   │   ├── Email (read-only)
│   │   └── Username (read-only)
│   └── Preferences
│       └── Timezone
│
├── Members (Admin/Owner only)
│   ├── Members Tab
│   └── Invitations Tab
│
├── Signing Keys
│   ├── Create (nsec once)
│   ├── Import
│   └── Bind to a hosted site
│
├── Notifications
│   ├── Notification Channels
│   ├── Email Digest
│   ├── Quiet Hours
│   └── Quick Mute
│
└── Security
    ├── Authentication
    ├── Active Sessions
    └── Account Deletion

Access Control

Different settings sections have different access requirements:

All Users

• General - Profile and preferences
• Notifications - Notification preferences
• Security - Security and account management

Admin and Owner Only

• Members - Team member management
  • Members without admin/owner permissions are automatically redirected to General settings

Owner Only

• Billing & subscription - The organization's platform subscription and seat counts are managed by Owners. See Billing, Pricing & Seats for how the org subscription is priced (per accountable actor) and how end-user seats work for apps you build on the platform.

Quick Links

Settings Overview

General Settings

Manage your profile and display preferences:

• Display Name - Your name as it appears across the platform
• Email - Your account email (managed by authentication provider)
• Username - Your unique identifier (permanent)
• Timezone - Display timezone for dates and times

Members Settings

Manage your organization's team (admin/owner only):

• View Members - See all organization members
• Invite Members - Send invitations to join your organization
• Manage Roles - Change member roles (member, admin, owner)
• Remove Members - Remove members from the organization
• Manage Invitations - View, resend, and cancel pending invitations

Notifications Settings

Control how you receive notifications:

• Channels - Enable/disable notification channels (in-app, email, etc.)
• Email Digest - Control email notification frequency
• Quiet Hours - Pause notifications during specific hours
• Quick Mute - Temporarily mute all notifications

Security Settings

Manage account security:

• Authentication - View authentication provider information
• Password Management - Change password (redirects to provider)
• Active Sessions - View current session information
• Account Deletion - Permanently delete your account

Settings Behavior

Immediate Updates

Most settings take effect immediately:

• Display name changes
• Notification channel toggles
• Email digest preferences
• Quiet hours settings

Browser Storage

Some preferences are stored locally in your browser:

• Timezone - Stored in localStorage, doesn't sync across devices

Server Storage

Most settings are stored on the server:

• Profile information
• Notification preferences
• Member management data
• Security settings

Related