oblien/openship

What is it?

Key features

• 01Builds and deploys from a GitHub repo, local folder, or prebuilt artifact
• 02Automatic Let's Encrypt TLS and reverse-proxy routing through an OpenResty edge
• 03Push-to-deploy via GitHub webhooks, rebuilding only changed monorepo services
• 04Snapshot-based rollbacks and redeploys
• 05Managed Postgres, MySQL, MongoDB, and Redis alongside apps
• 06Built-in SMTP mail server with DKIM, SPF, and DMARC support

Use cases

• Hosting your own apps on a VPS with automatic domains and HTTPS
• Deploying a small team's services with push-to-deploy from GitHub
• Driving remote servers from a desktop app without running an always-on control plane
• Automating deployments from scripts or AI agents via the CLI, SDK, or MCP endpoint

Quick start

1. 1

   Install the CLI with npm (requires Node.js 22+)

   npm i -g openship
2. 2

   Run the guided setup to create the first admin and start the control panel

   openship
3. 3

   Link your project directory, then deploy it

   cd your-project && openship init && openship deploy

Things to know

• !Push-to-deploy and public domains need an always-on server or Openship Cloud; the desktop app has no public endpoint.
• !Self-hosted Compose mode runs on Linux only and mounts the host Docker socket, so it is host-privileged and should run only on trusted hosts.
• !The from-source dev build is unverified and not meant for production use.

In collections

Topics

FAQ

What is openship?

Self-hostable deployment platform with built-in CI/CD that builds, routes, and TLS-secures apps from a repo, driven by desktop, web, or CLI. Openship is an open-source deployment platform you can run on your own machine or server. Point it at a GitHub repository, a local folder, or a prebuilt artifact, and it detects the stack, builds the app into a Docker image or bare release, runs it, and sets up a reverse-proxy route with a Let's Encrypt certificate. Each deploy is snapshotted so rollbacks and redeploys rerun exactly what shipped.

Is openship free to use? What license does it have?

openship is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.

Is openship still maintained?

Actively maintained. The last commit to openship was on Nov 7, 2026.

What can I use openship for?

Hosting your own apps on a VPS with automatic domains and HTTPS Deploying a small team's services with push-to-deploy from GitHub Driving remote servers from a desktop app without running an always-on control plane Automating deployments from scripts or AI agents via the CLI, SDK, or MCP endpoint

How do I install openship?

Install the CLI with npm (requires Node.js 22+): npm i -g openship Run the guided setup to create the first admin and start the control panel: openship Link your project directory, then deploy it: cd your-project && openship init && openship deploy

Where can I get openship?

The source code and installation instructions are on GitHub: https://github.com/oblien/openship