Skip to Content
DocumentationGetting Started

Getting Started

Get your first application deployed on Launcher in a few minutes.

Prerequisites

  • A server with SSH access (Ubuntu 22.04+ recommended)
  • A Launcher account at dash.lnchr.cloud 

Quick Start

1. Add a Server

From the dashboard, navigate to Servers and click Add Server. You’ll receive an install command that sets up the Launcher agent on your server.

curl -fsSL https://get.lnchr.cloud | sudo bash -s -- --token <your-token>

The agent installs Docker, configures the runtime environment, and establishes an outbound connection to the control plane. No inbound ports are required.

2. Create a Project

Projects group related applications, databases, and resources. Create one from the dashboard or via the API:

curl -X POST https://plane.lnchr.cloud/<tenant-id>/api/v1/projects \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"name": "my-project"}'

3. Deploy an Application

Create an application within your project. Launcher supports container images and git-based deployments.

curl -X POST https://plane.lnchr.cloud/<tenant-id>/api/v1/applications \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-app",
    "projectId": "<project-id>",
    "serverId": "<server-id>",
    "image": "nginx:latest",
    "ports": [{"container": 80, "public": 443}]
  }'

Your application will be deployed to the selected server and accessible via the configured domain.

What’s Next

  • Architecture — Understand how the system works under the hood.
  • Servers — Learn about server management and provisioning.
Last updated on
IntroductionArchitecture