Creating Your Organization
After creating your account, you need to create an organization to start using Orkestia. This guide walks you through the organization creation process.
What is an Organization?
An organization is a workspace that contains:
- Applications - Your deployed apps and services
- Team Members - People you invite to collaborate
- Connections - Cloud provider integrations (AWS, GitHub, etc.)
- Settings - Organization-wide configuration
- Subscriptions - Your platform subscription and billing (per-app subscriptions exist as add-ons)
Why Create an Organization?
You need an organization to:
- Deploy and manage applications
- Connect cloud providers (AWS, GitHub, etc.)
- Invite team members
- Manage subscriptions and billing
- Access organization-specific settings
Prerequisites
Before creating an organization, make sure you:
- Have an Account - You must be logged into Orkestia
- No Existing Organization - You can only create one organization per account (unless you're invited to others)
Creating Your Organization
Navigate to Onboarding
After logging in without an organization, you'll be automatically redirected to /onboarding. If you need to access it manually, navigate to /onboarding in your browser.
Enter Organization Details
The onboarding form has two fields:
Organization Name (Required)
- Examples: "Acme Corporation", "My Startup", "Development Team"
- Minimum: 1 character
- This name appears throughout Orkestia
- Can be changed later in settings
Domain (Optional)
- Examples: "acme.com", "example.org"
- Purpose: Used for future domain verification
- Format: Enter just the domain name (no http:// or www)
- Not required: You can skip this and add it later
Preview Your Organization
As you type the organization name, you'll see a preview card showing:
- Organization Avatar - Initials generated from the name
- Organization Name - The display name
- Domain - If provided
Create Organization
- Review your organization details
- Click Create organization
- Wait for the creation process to complete
The system will:
- Create your organization
- Set you as the organization admin
- Initialize your workspace
- Redirect you to the dashboard
Organization Status
After creation, your organization may have different statuses:
| Status | Description | Action Required |
|---|---|---|
| Active | Organization is ready to use | None - start deploying! |
| Pending Validation | Domain provided, awaiting verification | Complete domain verification (if applicable) |
What Happens After Creation
Once your organization is created:
- You're Redirected - Taken to the main dashboard
- Workspace Loads - Your organization data loads automatically
- You're the Admin - You have full permissions
- Ready to Use - You can start deploying applications
Organization Features
After creating your organization, you can:
Deploy Applications
Create and deploy your first app using Cloud Deploy.
Connect Providers
Set up AWS, GitHub, and other integrations.
Invite Members
Add team members to collaborate on projects.
Manage Settings
Configure organization preferences and security.
Tips for Organization Names
Choose a name that:
- Is Descriptive - Clearly identifies your team or company
- Is Professional - Use proper capitalization and spelling
- Is Unique - Helps distinguish your organization
- Reflects Purpose - Matches your use case (e.g., "Production", "Staging")
Common Questions
Can I change the organization name later?
Yes, you can update the organization name in settings after creation.
Do I need a domain?
No, the domain is optional. You can add it later if needed.
Can I create multiple organizations?
You can only create one organization per account. However, you can be invited to join other organizations.
What if I already have an organization?
If you try to create an organization but already have one, you'll see a message and be redirected to your dashboard.
Can I delete my organization?
Organization deletion is typically handled through support. Contact support if you need to delete an organization.
Next Steps
After creating your organization: