Managing Your Account
Learn how to view and update your profile, manage your account settings, and handle security preferences.
Accessing Account Settings
To access your account settings:
- Click your profile avatar in the top-right corner
- Select Settings from the dropdown menu
- Or navigate directly to
/settingsin your browser
The settings page has multiple sections:
| Section | Description |
|---|---|
| General | Profile information and preferences |
| Members | Team member management (admin only) |
| Notifications | Notification preferences |
| Security | Security and account deletion |
Profile Information
Your profile contains information about your account and how you appear in Orkestia.
Editable Fields
Display Name
Your display name appears across the platform:
- Required: Yes (minimum 2 characters)
- Usage: Shown in comments, activity logs, and team member lists
- Can be changed: Yes, anytime
To update your display name:
- Go to Settings > General
- Edit the Display Name field
- Click Save changes
Read-Only Fields
These fields are managed by your authentication provider and cannot be changed in Orkestia:
| Field | Description |
|---|---|
| Email Address | Managed by AWS Cognito, used for login and notifications |
| Username | Unique identifier (may include provider prefix like google_123456789) |
| Authentication Provider | How you signed up (Cognito, Google, GitHub, etc.) |
| Member Since | When you joined your first organization |
Preferences
Timezone Settings
Set your preferred timezone for displaying dates and times:
- Go to Settings > General
- Scroll to Preferences section
- Select your timezone from the dropdown
- Changes are saved automatically
Options:
- Auto - Use your browser's detected timezone (default)
- Specific Timezone - Choose from a list of timezones
Organization Memberships
View all organizations you belong to:
- Go to Settings > General
- Scroll to see your organization memberships
- Each organization shows:
- Organization name
- Your role (Admin, Member, etc.)
- Join date
Switching Organizations
To switch between organizations:
- Click your profile avatar in the top-right
- Select the organization from the dropdown
- You'll be switched to that organization's workspace
Leaving an Organization
To leave an organization:
- Contact the organization admin
- They can remove you from the organization
- Or use organization settings if you have permission
Security Settings
Manage your account security and authentication settings by navigating to Settings > Security.
Authentication
Your authentication is managed through AWS Cognito:
- Provider: AWS Cognito
- Security: Enterprise-grade authentication service
- Features: Password management, multi-factor authentication (if enabled)
Changing Your Password
To change your password:
- Go to Settings > Security
- Click Manage Password
- You'll be redirected to AWS Cognito's password management page
- Follow the instructions to change your password
Active Sessions
View information about your current session:
- Current Device - The device you're currently using
- Session Status - Active or expired
- Session Management - Handled by AWS Cognito
Account Deletion
You can permanently delete your account if you no longer need it.
Before Deleting
- Your user profile and settings
- All organization memberships
- All deployments and configurations
- All connection credentials
- All associated data
How to Delete Your Account
- Go to Settings > Security
- Scroll to Danger Zone
- Click Delete Account
- Read the warning carefully
- Type DELETE in the confirmation field
- Click Delete My Account
After Deletion
After deleting your account:
- You'll see a confirmation message
- You'll be automatically logged out
- Your account is scheduled for deletion
- All data is permanently removed
Common Questions
Can I change my email address?
Email addresses are managed by AWS Cognito. To change your email, use your authentication provider's settings or contact support.
Can I change my username?
No, usernames are permanent and cannot be changed. They're used as unique identifiers across the platform.
Can I have multiple accounts?
Yes, you can create multiple accounts with different email addresses. However, you typically only need one account and can join multiple organizations.
What happens if I delete my account?
All your data is permanently deleted, including profile information, organization memberships, deployments, and connection credentials. This action cannot be undone.
Can I recover a deleted account?
No, account deletion is permanent. Make sure you want to delete your account before confirming.
