+12
日增长
+162
周增长
+630
月增长
15,331
stars
1,409
forks
38
watchers
1,105
prs
666
issues
36
releases
README
Openship
Open-source, self-hostable deployment platform with built-in CI/CD.
Point it at a repo — it builds, ships, routes, and TLS-terminates your app. Drive it from a desktop app, web dashboard, or CLI.
Quick Start ·
How It Works ·
Interfaces ·
Docs ·
Contributing
---
Quick Start
There's one decision to make first: how you run Openship itself (the control plane). Everything else is the same afterwards.
| If you're… | Run Openship as | Where your apps run |
|---|---|---|
| Solo, one machine, no ops | Desktop app | A server you connect over SSH, or Openship Cloud |
| A team — or you want push-to-deploy / to host apps on your own box | Self-hosted server (openship up) | On that box (Compose mode) — or out to another server / Cloud (bare mode) |
| Not interested in running anything | Openship Cloud | Managed sandboxes, zero setup |
[!TIP]
Solo? Use the desktop app. It runs Openship's control plane on your own machine only while the app is open — nothing is left running on an always-on server, nothing is exposed publicly. You only need an always-on server install once you want push-to-deploy (CI/CD), team access, or to host apps on that box — the things that need a public, always-on endpoint.
Solo — desktop app
The control plane runs locally and drives your servers over SSH. No login, no terminal, no public surface — download, open, done:
| Platform | Download |
|---|---|
| macOS (Apple Silicon) | Openship-arm64.dmg |
| macOS (Intel) | Openship-x64.dmg |
| Windows | Openship-win32-x64.zip |
| Linux | Openship.AppImage |
Linux: chmod +x Openship.AppImage && ./Openship.AppImage. Already have the CLI? openship install fetches and launches it. Links always point at the newest release.
From the desktop app you connect a server (SSH) or Openship Cloud and deploy to it — the app itself doesn't host public apps on your laptop.
Team / always-on — self-hosted server
Install the CLI (it bundles the API + dashboard), then run openship — an interactive wizard creates the first admin, wires your domain, and installs Openship as a boot service. Run it again anytime to manage the instance.
bash
curl -fsSL https://get.openship.io | sh install (or: npm i -g openship — needs Node 22+)
openship guided setup, then control panel
The install script brings its own Node when your system one is older than 22; a package-manager
install runs on the Node you already have.
For CI / headless boxes, skip the wizard and drive openship up directly:
bash
openship up install + start as a background service (boots + auto-restarts)
openship up --public-url https://openship.example.com + serve the dashboard on your domain (edge + TLS handled)
openship up picks how it runs for you:
- On Linux with Docker → Compose mode (the default). Brings up the full stack — Postgres, Redis, API, daTop issues
#231Discussion: multi-process apps and the single-start-command model (Laravel as the case study)26 comments · 2026-07-25#935[Feature]: runtime roles for stacks (web, worker, scheduler)23 comments · 2026-09-23#527Experience as first time / new user20 comments · 2026-08-09#92[Feature]: Canvas feature8 comments · 2026-07-22#148Help us Keep OpenShip more secure :7 comments · 2026-07-23#75[Feature]: First-class GitLab integration (connect, push-to-deploy, MR previews)6 comments · 2026-07-21#1570Default host ports (3000 / 3001 / 4000) collide with common dev tools; compose has no fallback3 comments · 2026-11-03#216Help: Heavy tests needed for the stable release3 comments · 2026-07-24
Discussions
#963Example of deploy workflow0 comments · 2026-09-27#733Community client: Openship-App — Android (Kotlin Multiplatform) mobile companion1 comments · 2026-08-26#537Running with podman1 comments · 2026-08-10#393No Way to Register an Account Upon initial Setup0 comments · 2026-08-02#266Support source-less service projects for shared infrastructure such as Redis and PostgreSQL1 comments · 2026-07-28#252[Shoutout & Ecosystem Integration] OpenShip as the Orchestration Foundation for DROS-VEP-lite0 comments · 2026-07-27#180Does openship have "first-class Forgejo" support?0 comments · 2026-07-23#157Discrod server for discussion0 comments · 2026-07-23
Latest release
OpenShip v0.9.12 v0.9.12 2026-11-12Critical update for build-secret protection, database upgrade repairs and backup/restore reliability. Includes all changes since 0.9.11, with reviewed source-image update PRs, platform imports, mail improvements and a translated website. Build security - Pass generated Docker build environments through temporary BuildKit secrets instead of embedding values in Dockerfiles or image history. Mask configured values in streamed logs, error summaries and failure notifications, including split and multiline output. Preserve Cloud worker limits, parallel server builds and cleanup after cancel