Out Plane LogoOut Plane

Quick Start

Deploy your first application on Out Plane in under 5 minutes

This guide walks you through deploying your first application on Out Plane—from sign-up to a live URL.

Prerequisites

Before you begin:

  • A GitHub account with at least one repository
  • Application code ready to deploy (Node.js, Python, Go, or any Dockerized app)

Step 1: Sign Up & Create Team

  1. Go to console.outplane.com
  2. Click Sign in with GitHub and authorize Out Plane
  3. Create your first team—choose a name and slug

Teams isolate resources and billing. You can create multiple teams for different projects or organizations.

Step 2: Install GitHub App

Out Plane needs access to your repositories to deploy code.

  1. From the Applications page, click Deploy Application
  2. Click Install GitHub App when prompted
  3. Select repository access:
    • All repositories — Access all current and future repos
    • Select repositories — Choose specific repos
  4. Click Install to complete

You'll be redirected back to Out Plane automatically.

Step 3: Create Application

Select Repository

  1. Choose a repository from the list
  2. Select the branch to deploy (defaults to main or master)
  3. Set root directory if your app is in a subdirectory (default: /)

Configure Build

SettingDescription
Build MethodDockerfile (use your Dockerfile) or Buildpack (auto-detect)
App NameUnique identifier, used in your default domain
PortPort your application listens on (e.g., 3000, 8080)

Select Resources

InstancevCPURAMNotes
op-200.5512 MBFree tier, for testing
op-4611 GBSmall production apps
op-8222 GBMedium workloads
op-9444 GBHigh-performance

Configure Scaling

  • Min Scale: Set to 0 for scale-to-zero (serverless), or 1+ for always-on
  • Max Scale: Maximum instances under load (1-10)

Add Environment Variables (Optional)

Click Add Variable to set environment variables:

NODE_ENV=production
DATABASE_URL=postgresql://user:pass@host/db
API_KEY=your-secret-key

Environment variables are encrypted at rest and injected at runtime.

Step 4: Deploy

Click Create Application to start the deployment.

Out Plane will:

  1. Clone your repository
  2. Build a container image (Dockerfile or Buildpack)
  3. Deploy to the infrastructure
  4. Provision your domain with SSL

Monitor Build Progress

The deployment page shows real-time build logs. Typical deployments take 2-5 minutes.

StatusMeaning
QueuedWaiting for build resources
BuildingInstalling dependencies, building container
DeployingPushing to infrastructure
ReadyLive and serving traffic
FailedError occurred—check build logs

Step 5: Access Your Application

Once the status shows Ready:

  1. Go to the application Overview tab
  2. Find your domain: yourapp.outplane.app
  3. Click to open your live application

You'll also see:

  • Internal URL for service-to-service communication
  • Last commit that was deployed
  • Configuration summary

Next Steps

Now that your application is running:

TaskWhere
View runtime logsApplication → Logs tab
View HTTP requestsApplication → HTTP Logs tab
Add custom domainDomains page
Manage environment variablesApplication → SettingsEnvironment
Invite team membersSettingsMembers
Create a databaseDatabases page

Troubleshooting

Build Failed

  1. Check the build logs for error messages
  2. Verify your Dockerfile or package.json is correct
  3. Ensure all dependencies are listed
  4. Check that environment variables are set

Application Not Starting

  1. Verify the port matches your application's listen port
  2. Check runtime logs for errors
  3. Ensure your app responds to HTTP requests on the configured port

Can't See Repository

  1. Go to GitHub → Settings → Applications → Out Plane
  2. Click Configure and grant access to the repository
  3. Refresh the repository list in Out Plane

Learn More