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.
Paid organizations
After creating a paid organization, Bosco guides you through the setup in a full-screen flow:
- Billing details — company name, address and tax information that appear on invoices.
- Payment method — a card saved through Stripe. Nothing is charged at this step.
- 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:
- Click on your Organization name at the bottom left of the sidebar
- Select Settings from the dropdown menu
- Navigate through the tabs: Projects, Members, Payments, Credits, Information, Support
Organization Settings
| Setting | Description |
|---|---|
| Name | Your organization's display name |
| Primary contact email for notifications | |
| Billing Email | Email used for invoices and billing notifications when billing is enabled |
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:
- Click on your Organization name at the bottom left of the sidebar
- Select Settings from the dropdown
- In the Projects tab, click Create Project
- Enter a project name (e.g.,
production) - Choose a Location — every resource in this project will be deployed there. The location cannot be changed after creation.
- Click Create
When an organization has no project yet, SailOps shows a dedicated start page where you can create one directly.
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:
- Select your project from the project switcher in the sidebar
- Click Settings in the project sidebar navigation
Docker Registry
If you're using private Docker images:
- Go to Settings in the project sidebar
- Select the Docker Registry tab
- Click Add Registry
- Enter your registry credentials:
- Registry URL (e.g.,
ghcr.io,registry.gitlab.com) - Username
- Password/Token
- Registry URL (e.g.,
- Click Save
DNS Providers
For custom domains with automatic SSL:
- In Project Settings, select the DNS Providers tab
- Click Add Provider
- Select your DNS provider (Cloudflare, Route53, etc.)
- Enter your API credentials
- Click Save
API Keys
For programmatic access:
- In Project Settings, select the API Keys tab
- Click Generate New Key
- Give your key a descriptive name
- Copy and store the key securely (it won't be shown again)
Invite Team Members
To collaborate with your team:
- Open Organization Settings (click your Organization name at bottom left > Settings)
- Select the Members tab
- Click Invite Member
- Enter their email address
- 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:
- Open Organization Settings (click your Organization name at bottom left > Settings)
- Select the Payments tab
- Click Add Payment Method
- Enter your card details
- 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:
Questions about organization setup? Contact us at [email protected]