Managing Organizations

Organizations are the top-level container in Teabar. They contain projects, members, and define billing boundaries.

Creating an Organization

Via Web Console

1. Log in to teabar.dev/app
2. Click your profile menu (top right)
3. Select “Create Organization”
4. Enter organization details:
   • Name: Unique identifier (lowercase, hyphens allowed)
   • Display Name: Human-readable name
   • Billing Email: For invoices and billing notifications
5. Click “Create Organization”

Via CLI

teactl org create my-company --display-name "My Company Inc"

Organization Settings

Access organization settings via the web console or CLI.

General Settings

Update via CLI:

teactl org update my-company --display-name "My Company International"

Billing Settings

Access billing settings in the web console under Organization Settings > Billing.

• Current Plan: View active subscription tier
• Usage: Current period usage and costs
• Payment Method: Credit card or invoice billing
• Invoices: Download past invoices

Organization Dashboard

The organization dashboard provides an overview of:

Usage Summary

• Environments: Total environments, running vs. stopped
• Compute: vCPU-hours consumed this billing period
• Storage: Persistent storage in use
• Estimated Cost: Projected cost for current period

Activity Feed

Recent activity across the organization:

• Environment creations and deletions
• Member joins and departures
• Blueprint updates
• Administrative actions

Quick Actions

• Create new project
• Invite members
• Generate API key
• View audit logs

Multiple Organizations

Users can belong to multiple organizations with different roles.

Switching Organizations

Web Console:

• Click organization name in sidebar
• Select from dropdown

CLI:

# List your organizations
teactl org list

# Switch active organization
teactl org switch other-company

# View current context
teactl config get current-context

Organization Context

The CLI maintains an active organization context. Commands operate within this context:

# These commands use the current organization context
teactl project list
teactl member list
teactl env list

Override with --org flag:

teactl project list --org other-company

Deleting an Organization

Requirements

• You must be an organization admin
• All running environments must be stopped
• Outstanding balance must be paid (Cloud plans)

Via Web Console

1. Go to Organization Settings > Danger Zone
2. Click “Delete Organization”
3. Type the organization name to confirm
4. Click “Permanently Delete”

Via CLI

# Force stops running environments and deletes
teactl org delete my-company --force

# Interactive confirmation
teactl org delete my-company

Organization Limits

Limits vary by plan:

Best Practices

Naming Conventions

• Use lowercase with hyphens: acme-corp, training-team
• Keep names short but descriptive
• Consider using company domain as prefix: acme-production, acme-staging

Organization Structure

Single Organization - Best for:

• Small teams
• Single project or product
• Unified billing

Multiple Organizations - Best for:

• Separate billing entities
• Different security boundaries
• Client work (agency model)

Security Recommendations

1. Limit admin access - Only grant admin role to those who need it
2. Regular access reviews - Periodically audit member list
3. Use API keys wisely - Create scoped keys, set expiration dates
4. Enable audit logging - Monitor for suspicious activity

See Also

• Projects - Managing projects within organizations
• Members - Member management
• teactl org - CLI organization commands
• Organizations Concept - Understanding the organization model