Getting Started
This guide walks you through creating your Orkestia account and completing your first login.
Prerequisites
Before you begin, make sure you have:
- Email Address - A valid email address for account creation and verification
- Web Browser - A modern web browser (Chrome, Firefox, Safari, or Edge)
- Internet Connection - Stable internet connection for authentication
Two Paths to Get Started
You can create an account in two ways:
Path 1: Create a New Account
Use this path if you're starting fresh and want to create your own organization.
Path 2: Accept an Invitation
Use this path if you've received an invitation email to join an existing organization. See Invitations for detailed instructions.
Step 1: Navigate to Registration
Go to the Orkestia website
Navigate to the Orkestia website and click Sign Up or Create Account in the navigation.
Choose Your Sign-Up Method
Orkestia uses AWS Cognito for secure authentication. You can sign up using:
- Email and Password - Create an account with your email address
- Social Providers - Sign up with Google, GitHub, or other configured providers
Complete Registration
Email/Password Sign-Up:
- Enter your email address
- Create a password (must meet security requirements)
- Click Sign Up
Social Provider Sign-Up:
- Click your preferred provider (Google, GitHub, etc.)
- Complete authentication with the provider
- Grant permissions if prompted
Email Verification
After signing up, you'll receive a verification email:
- Check your email inbox
- Click the verification link in the email
- You'll be redirected back to Orkestia
What Happens After Authentication
After successful authentication, Orkestia checks your account status:
If You Have an Organization
- You're redirected to the dashboard
- Your workspace loads automatically
- You can start deploying applications immediately
If You Don't Have an Organization
- You're redirected to the onboarding page
- You'll need to create an organization to continue
- See Create Organization for next steps
If You Have a Pending Invitation
- Any pending invitations are processed automatically
- You're immediately added to the organization
- You'll see a success message when logging in
- No manual acceptance needed
Authentication Flow
Security Features
Orkestia uses industry-standard security practices:
| Feature | Description |
|---|---|
| HttpOnly Cookies | Tokens stored securely, not accessible to JavaScript |
| AWS Cognito | Enterprise-grade authentication service |
| OAuth 2.0 | Standard authorization flow |
| Email Verification | Ensures email ownership |
| Session Management | Secure session handling |
Account Information
Your account includes:
- Email Address - Used for login and notifications
- User Profile - Name, avatar, and preferences
- Organization Memberships - Organizations you belong to
- Role Assignments - Your role in each organization
Next Steps
After creating your account:
Troubleshooting
If you encounter issues during account creation:
- Email not received? Check spam folder and wait a few minutes
- Verification link expired? Request a new verification email
- Authentication errors? See Troubleshooting