Organizations

Organizations are workspaces that group your projects, team members, servers, and resources together. Each organization has its own settings, billing, and access controls.

Creating an Organization

1. Log in to OEC.sh
2. Click the organization dropdown in the top navigation
3. Select "Create Organization"
4. Enter a name and URL slug for your organization
5. Click "Create"

You automatically become the Owner of any organization you create.

Switching Between Organizations

If you belong to multiple organizations:

1. Click the organization dropdown in the top navigation
2. Select the organization you want to switch to
3. The dashboard updates to show that organization's data

Inviting Team Members

Owners and Admins can invite new members to the organization.

1. Go to Settings in the sidebar
2. Click the Members tab
3. Click Create Invitation
4. Enter the email address of the person you want to invite
5. Select their role (Admin, Developer, or Viewer)
6. Optionally configure:
   • Expiration: 1-30 days
   • Max Uses: How many times the invitation can be used
   • Message: Optional note to include
   • Project Access: Limit to specific projects
7. Click Send Invitation

The invited person receives an email with a link to join your organization.

Managing Invitations

From the Members tab, you can:

• Copy invitation code to share manually
• Resend invitations to remind invitees
• Revoke invitations to cancel pending invites
• Clean up expired or revoked invitations

Member Roles

Organizations have four member roles that control organization-level access. These are part of the platform's RBAC system with 55+ permissions across 6 system roles.

Team Member Limits by Plan

Owner

• Full control over the organization
• Manages billing and subscriptions
• Admin access to all projects (safety net)
• Only one Owner per organization

Admin

• Manages all organization resources
• Invites and removes team members
• Creates and configures servers, storage, and integrations
• Cannot access billing

Developer

• Creates projects
• Views organization resources
• Cannot invite members or modify infrastructure

Viewer

• Read-only access to organization resources
• Cannot create, modify, or delete anything

Important: Organization roles control access to organization-level features (members, servers, storage, billing). Project access is controlled separately through Teams. See Teams for details.

Note: Owner role cannot be assigned through invitations. The organization creator is automatically the Owner.

For detailed member management, see Members. For permissions and RBAC, see Permissions.

Managing Members

Changing a Member's Role

1. Go to Settings > Members tab
2. Find the member in the list
3. Click the three-dot menu next to their name
4. Select Edit Role
5. Choose the new role from the dropdown
6. Click Save

Note: You cannot change the Owner's role through the UI.

Removing a Member

1. Go to Settings > Members tab
2. Find the member you want to remove
3. Click the three-dot menu next to their name
4. Select Remove
5. Confirm the removal

Removed members immediately lose access to the organization.

Viewing Role Permissions

Expand the Role Permissions section in the Members tab to see exactly what each role can do. Permissions are shown with checkmarks (allowed) and X marks (denied).

Organization Settings

Access organization settings from the sidebar by clicking Settings. The settings page has multiple tabs:

Team

Members Tab

• Manage organization members and their roles
• Create and manage invitations
• View role permissions reference

Teams Tab

• Create and manage teams
• Add or remove team members
• Teams control project access (see Teams)

Permissions Tab

• View permission matrix for all roles
• Access audit logs for permission changes

Cloud & Infrastructure

Cloud Accounts Tab

• Connect cloud provider accounts (AWS, DigitalOcean, Hetzner, etc.)
• Used for Quick Setup of DNS and Storage

DNS Providers Tab

• Set up DNS providers for custom domain management
• Configure Cloudflare, Route53, Azure DNS, etc.

Storage Providers Tab

• Configure backup storage providers (S3, R2, B2, etc.)
• Set default storage for backups

Development

Git Connections Tab

• Connect GitHub or GitLab accounts for repository access
• Configure OAuth or Personal Access Tokens

Addon Repos Tab

• Manage addon repository sources
• Configure private addon repositories

Billing

Subscription Tab

• View your current subscription plan
• Upgrade or change plans
• Access Stripe customer portal

Usage Tab

• View resource usage statistics
• Monitor quota consumption

System

Cleanup Policy Tab

• Configure server cleanup policies
• Set automatic cleanup schedules for unused resources

Closing Your Organization

Closing an organization follows a structured process with safeguards and a 30-day grace period.

Before Closing

Review your organization's impact before proceeding:

1. Active Projects: Number of projects that will be affected
2. Running Environments: Environments that will be stopped
3. Team Members: Members who will lose access
4. Scheduled Backups: Backup jobs that will be cancelled
5. Active Subscriptions: Billing that will be stopped

Starting the Closure Process

1. Go to Settings > Organization > Danger Zone
2. Click Close Organization
3. Review the impact analysis showing:
   • Active resources count
   • Team members affected
   • Backup and deployment status
4. Type the organization name to confirm
5. Click Confirm Closure

Grace Period (30 Days)

When you close an organization:

• Immediate: Your organization enters a "grace" state
• Access: Limited access (read-only) for 30 days
• Data Preservation: All data is kept intact during the grace period
• Billing: Subscription is cancelled immediately
• Resources: All environments are stopped

Reactivating During Grace Period

Changed your mind? You can reactivate within 30 days:

1. Log in to OEC.sh
2. You'll see a banner about your organization's grace status
3. Click Reactivate Organization
4. Your organization is restored with all data intact
5. Resume your subscription if needed

Permanent Deletion (After 30 Days)

After the 30-day grace period:

• Permanent deletion of all organization data
• Credential scrubbing for security (removes all passwords, tokens, API keys)
• No recovery -- data cannot be restored after this point

Alternative: Transferring Ownership

Instead of closing, consider transferring ownership:

1. Invite the new owner to your organization
2. Change their role to Owner
3. They can then manage the organization
4. You can downgrade your own role or leave