What is Launchpad?¶

Launchpad is a GitHub Action that provisions and manages LXC containers on MIE's open source Proxmox cluster. It deploys Docker/OCI images as containers with automatic networking, DNS, and reverse proxy configuration.

GitHub Marketplace

View Launchpad on the GitHub Actions Marketplace

How It Works¶

sequenceDiagram
    participant GH as GitHub Actions
    participant LP as Launchpad Action
    participant API as Create-a-Container API
    participant PVE as Proxmox VE

    GH->>LP: Trigger (push/PR/delete)
    LP->>API: POST /containers (API key auth)
    API->>PVE: Create/update LXC container
    PVE-->>API: Container ready
    API-->>LP: Container details (URL, SSH)
    LP-->>GH: Output access info

Workflow trigger — A push, PR, or branch event triggers the action
API call — The action authenticates with an API key and requests a container from the create-a-container server
Container provisioning — The server pulls the specified Docker/OCI image and creates an LXC container on Proxmox
Access — The container gets a public URL and SSH access automatically

What You Get¶

Each container provides:

Feature	Details
Public domain	`https://<hostname>.os.mieweb.org`
SSH access	Direct terminal access via assigned port
Networking	Automatic DNS and nginx reverse proxy configuration
Security monitoring	Integrated with Wazuh security system
Authentication	Connected to MIE's LDAP authentication system

Key Features¶

Docker/OCI image support — Deploy from Docker Hub, GHCR, or any OCI registry
API-key authentication — No Proxmox credentials needed in your workflow
PR preview environments — Automatically deploy previews on pull requests and clean up on close
Container lifecycle management — Create, update, and destroy containers via CI/CD
Service registry — HTTP, HTTPS, TCP/UDP, and DNS services are automatically configured

Next Steps: See the Getting Started guide to set up Launchpad in your repository.