Skip to main content

Organization Setup

Review the organization created during registration, then create the project that will host your resources.

Understanding Organizations​

An Organization is the top-level entity in SailOps. It contains:

  • Projects - Isolated environments for your resources
  • Members - Team members with different roles and permissions
  • Billing - Payment methods and invoices
  • Settings - Organization-wide configuration

Initial State​

When you sign up, SailOps takes you to the Welcome page — the organization hub — where you can start a free trial or create a paid organization.

After creating a paid organization, Bosco guides you through the setup in a full-screen flow:

  1. Billing details — company name, address and tax information that appear on invoices.
  2. Payment method — a card saved through Stripe. Nothing is charged at this step.
  3. First project — name it and pick a location. You can also skip and create one later.

The console stays locked until both billing details and a payment method are saved. Members who cannot manage billing see a message asking them to wait for an owner to finish the setup.

Trial organizations​

Trial organizations skip this flow entirely. No payment method is required, and a project is provisioned automatically.

Review Organization Settings​

To access organization settings:

  1. Click on your Organization name at the bottom left of the sidebar
  2. Select Settings from the dropdown menu
  3. Navigate through the tabs: Projects, Members, Payments, Credits, Information, Support

Organization Settings​

SettingDescription
NameYour organization's display name
EmailPrimary contact email for notifications
Billing EmailEmail used for invoices and billing notifications when billing is enabled
Trial organization

The organization remains usable while trial credits are available. Add a payment method only when you are ready to move beyond the trial or avoid suspension at trial expiry.

Create Your First Project​

Projects provide isolated environments for your resources. Common patterns include:

  • Environment-based: production, staging, development
  • Application-based: web-app, api-service, admin-panel
  • Team-based: frontend, backend, data

Create a Project​

If you skipped project creation during the setup flow, or need another project:

  1. Click on your Organization name at the bottom left of the sidebar
  2. Select Settings from the dropdown
  3. In the Projects tab, click Create Project
  4. Enter a project name (e.g., production)
  5. Choose a Location — every resource in this project will be deployed there. The location cannot be changed after creation.
  6. Click Create

When an organization has no project yet, SailOps shows a dedicated start page where you can create one directly.

Project Naming

Use lowercase names with hyphens for consistency. Projects can be renamed later, but the internal ID remains unchanged.

Configure Project Settings​

Each project has its own configuration:

  1. Select your project from the project switcher in the sidebar
  2. Click Settings in the project sidebar navigation

Docker Registry​

If you're using private Docker images:

  1. Go to Settings in the project sidebar
  2. Select the Docker Registry tab
  3. Click Add Registry
  4. Enter your registry credentials:
    • Registry URL (e.g., ghcr.io, registry.gitlab.com)
    • Username
    • Password/Token
  5. Click Save

DNS Providers​

For custom domains with automatic SSL:

  1. In Project Settings, select the DNS Providers tab
  2. Click Add Provider
  3. Select your DNS provider (Cloudflare, Route53, etc.)
  4. Enter your API credentials
  5. Click Save

API Keys​

For programmatic access:

  1. In Project Settings, select the API Keys tab
  2. Click Generate New Key
  3. Give your key a descriptive name
  4. Copy and store the key securely (it won't be shown again)

Invite Team Members​

To collaborate with your team:

  1. Open Organization Settings (click your Organization name at bottom left > Settings)
  2. Select the Members tab
  3. Click Invite Member
  4. Enter their email address
  5. Select a role:
    • Owner - Full administrative control including billing
    • Maintainer - Administrative access without billing
    • Developer - Create and manage resources
    • Reporter - Read-only access to resources
    • Guest - Limited read-only access

Set Up Payment​

Payment is optional during the trial. Add it when you want to continue after trial credits are exhausted or when your organization requires uninterrupted paid usage:

  1. Open Organization Settings (click your Organization name at bottom left > Settings)
  2. Select the Payments tab
  3. Click Add Payment Method
  4. Enter your card details
  5. Click Save

Organization Checklist​

Use this checklist to ensure your organization is properly configured:

  • Complete the guided setup (billing details and payment method) for paid organizations
  • Review organization name and contact email
  • Create at least one project
  • Configure Docker registry (if using private images)
  • Set up DNS provider (if using custom domains)
  • Invite team members
  • Verify terms of service acceptance in the Terms tab
  • Add a payment method before trial expiry if you want uninterrupted usage

Next Steps​

With your organization set up:

  1. Deploy your first container
  2. Set up monitoring alerts
  3. Understand billing

Questions about organization setup? Contact us at [email protected]