Skip to main content

Organizations

Organizations are the top-level entity in Deployxa. They represent your company, team, or project group and contain all your projects, members, and billing information.

What is an Organization?​

An organization is a container for:

  • Projects: All your deployed applications
  • Members: Team members with different roles
  • Billing: Payment methods and invoices
  • Settings: Organization-wide configurations
  • Domains: Custom domains shared across projects

Creating an Organization​

Step 1: Sign Up​

  1. Visit deployxa.com
  2. Click "Get Started"
  3. Sign up with email or GitHub

Step 2: Create Organization​

  1. Click "Create Organization"
  2. Enter organization details:
    • Name: Your organization name (e.g., "acme-corp")
    • Display Name: Human-readable name (e.g., "Acme Corporation")
    • Description: Optional description
  3. Choose your plan
  4. Click "Create Organization"

Step 3: Verify​

You'll receive a verification email. Click the link to verify your organization.

Organization Settings​

General Settings​

Access via Settings → General

Available Settings:

  • Organization name
  • Display name
  • Description
  • Default region
  • Default environment variables

Security Settings​

Access via Settings → Security

Available Settings:

  • Two-factor authentication (2FA)
  • Session timeout
  • IP whitelist
  • SSO configuration (Enterprise)

Billing Settings​

Access via Settings → Billing

Available Settings:

  • Payment methods
  • Billing cycle
  • Budget alerts
  • Invoice history

Organization Members​

Roles​

Deployxa supports three member roles:

Owner​

  • Full access to all organization features
  • Can manage billing and subscriptions
  • Can add/remove members
  • Can delete organization
  • Can manage all projects

Admin​

  • Can create and manage projects
  • Can add/remove members (except Owners)
  • Can manage project settings
  • Cannot manage billing
  • Cannot delete organization

Developer​

  • Can view and deploy to assigned projects
  • Can view logs and metrics
  • Cannot create new projects
  • Cannot manage members
  • Cannot access billing

Adding Members​

  1. Go to Settings → Members
  2. Click "Invite Member"
  3. Enter email address
  4. Select role (Admin or Developer)
  5. Click "Send Invitation"

The invitee will receive an email with instructions to join.

Removing Members​

  1. Go to Settings → Members
  2. Find the member in the list
  3. Click the three-dot menu
  4. Select "Remove Member"
  5. Confirm removal

Note: Owners cannot be removed unless they transfer ownership first.

Transferring Ownership​

  1. Go to Settings → Members
  2. Find the new owner
  3. Click "Transfer Ownership"
  4. Confirm the transfer

Important: The current owner will be downgraded to Admin.

Organization Projects​

Viewing Projects​

Access via Dashboard → Projects

All organization projects are listed with:

  • Project name
  • Status (Active, Suspended, Deleted)
  • Last deployment
  • Resource usage
  • Quick actions

Creating Projects​

See Creating Your First Project

Project Limits​

Free Tier:

  • 3 projects per organization
  • 100 GB bandwidth/month

Pro Tier:

  • Unlimited projects
  • 1 TB bandwidth/month

Enterprise Tier:

  • Unlimited projects
  • Custom bandwidth limits

Organization Billing​

Billing Cycle​

Organizations are billed monthly or annually (annual saves 20%).

Payment Methods​

Supported payment methods:

  • Credit/Debit cards (Visa, Mastercard, Amex)
  • PayPal
  • Bank transfer (Enterprise only)

Invoices​

Invoices are generated automatically and available in Settings → Billing → Invoices.

Each invoice includes:

  • Billing period
  • Resource usage breakdown
  • Total amount
  • Payment status

Budget Alerts​

Set budget alerts to avoid unexpected charges:

  1. Go to Settings → Billing
  2. Click "Set Budget Alert"
  3. Enter threshold amount
  4. Choose notification method (email, webhook)
  5. Click "Save"

You'll receive notifications when usage reaches 50%, 75%, 90%, and 100% of your budget.

Organization Domains​

Shared Domains​

Domains can be shared across multiple projects within an organization.

Benefits:

  • Centralized domain management
  • Automatic SSL for all projects
  • DNS configuration in one place

Adding Domains​

  1. Go to Settings → Domains
  2. Click "Add Domain"
  3. Enter domain name (e.g., "example.com")
  4. Configure DNS records
  5. Click "Verify"

See Custom Domains for detailed instructions.

Organization Security​

Two-Factor Authentication (2FA)​

Require all members to enable 2FA:

  1. Go to Settings → Security
  2. Enable "Require 2FA for all members"
  3. Click "Save"

Members will be prompted to set up 2FA on their next login.

IP Whitelist​

Restrict access to specific IP addresses:

  1. Go to Settings → Security
  2. Enable "IP Whitelist"
  3. Add allowed IP addresses or ranges
  4. Click "Save"

Note: Be careful not to lock yourself out!

Session Timeout​

Configure automatic logout after inactivity:

  1. Go to Settings → Security
  2. Set "Session Timeout" (e.g., 30 minutes)
  3. Click "Save"

Audit Logs​

Track all organization actions:

  1. Go to Settings → Audit Logs
  2. View recent actions
  3. Filter by user, action type, or date range

Audit logs include:

  • Member additions/removals
  • Project creations/deletions
  • Deployment triggers
  • Setting changes
  • Billing changes

Organization Deletion​

Warning: Deleting an organization is permanent and cannot be undone.

Before Deletion​

  1. Transfer or delete all projects
  2. Remove all members
  3. Cancel any active subscriptions
  4. Download all invoices

Deletion Process​

  1. Go to Settings → General
  2. Scroll to "Danger Zone"
  3. Click "Delete Organization"
  4. Enter organization name to confirm
  5. Click "Delete Organization"

All organization data will be permanently deleted within 30 days.

Best Practices​

Organization Naming​

  • Use lowercase letters and hyphens
  • Keep it short and memorable
  • Avoid special characters
  • Use your company or team name

Member Management​

  • Follow the principle of least privilege
  • Regularly review member access
  • Remove inactive members
  • Use teams for large organizations

Security​

  • Enable 2FA for all members
  • Use strong passwords
  • Regularly rotate API keys
  • Monitor audit logs

Billing​

  • Set budget alerts
  • Review invoices monthly
  • Monitor resource usage
  • Upgrade plans before hitting limits

Troubleshooting​

Cannot Create Organization​

Problem: "Organization name already taken"

Solution: Choose a different name or contact support if you believe this is an error.

Cannot Add Members​

Problem: "Member limit reached"

Solution: Upgrade your plan or remove inactive members.

Billing Issues​

Problem: Payment failed

Solution:

  • Check payment method details
  • Ensure sufficient funds
  • Try a different payment method
  • Contact support if issue persists

Need Help? Contact support@deployxa.com or join our community Discord.