Every Lucity project has an Eject button. It downloads your services, databases and domains in a standard format any major cloud can run, without Lucity. You will probably never press it. Here is exactly what happens if you do.
The export is the chart every Lucity environment is deployed with, plus one file per environment that says how yours is set up. Click through it.
One environment as it runs right now: every service with its image, variables, instances, resources and domains, plus its databases, key-value stores and volumes. The marked lines name things that only exist on Lucity, so you change them.
gateway: # yours to change name: lucity-gateway namespace: lucity-system imagePullSecrets: [ ... ] # yours to change services: web: image: repository: registry.example.com/shop/web tag: 9b1e4d0 replicas: 2 domains: - host: shop.example.com issuerRef: { kind: ClusterIssuer, name: ... } # yours to change databases: postgres: main: { instances: 2, size: 10Gi }
The archive holds your variables in plain text, secrets included, along with the passwords of your key-value stores. Keep it where you would keep a password, and out of public repositories.
Ejecting copies your configuration. It is not a migration. This is what the zip carries, what you bring, and what becomes your job once we are out of the picture.
Only what your project uses. Every part is open source, and the readme in the download lists them again.
| If the project has | The cluster needs |
|---|---|
| Services | Kubernetes 1.33 or newer, on nodes with user namespaces (Linux 6.3+, containerd 2.0+ or CRI-O) |
| Databases, key-value stores or volumes | A default StorageClass |
| PostgreSQL databases | The CloudNativePG operator |
| Domains | A Gateway API implementation and a Gateway reachable from the internet |
| Custom domains | ListenerSet support on that Gateway, and cert-manager 1.20+ with an HTTP-01 ClusterIssuer |
| Autoscaling | metrics-server |
Most platforms get expensive the day you outgrow them, because your setup lives in their dashboard. Here the next step is a choice you make, not a project you start.
Push, and it is live. A repository becomes a running app with an address and HTTPS.
A database in one click. Linked to your services, with no passwords copied around.
Production, with a team. A customer's domain, real traffic and colleagues with access.
A reason to change something. Compliance wants your own hardware, or you have grown a platform team.
From here, three ways to go on. It is the same chart underneath all of them.
Stay
Keep shipping on Lucity. Nothing about your app changes as it grows, and you can take an export any time, just to have one.
Eject
Install the export on a cluster that fits the list above. Builds, backups and monitoring become yours. The eject guide
Self-host
Lucity is open source. Install it with the same two Helm charts we run, and keep the dashboard, builds and push to deploy. Budget an afternoon for the first install. Self-hosting
Still wondering about something? Ask us
No. The project keeps running exactly as before, so you can eject to keep a copy, to try your own cluster first, or to move for good. The export is a snapshot: changes you make on Lucity afterwards need a fresh one.
No. Nothing in the export calls home, needs a license key or talks to Lucity.
No. The export is configuration. Databases, key-value stores and volumes come up empty on your cluster, and bucket files stay in their buckets. The guide shows how to copy each of them.
Yes, a short one that you plan. There is no live migration: writes have to stop while the data is copied, and custom domains wait a minute or two for new certificates after the DNS switch.
Yes. Lucity is open source, so you can install the full platform on your own cluster and keep the dashboard, builds and push to deploy. It is not a one-command install, and the self-hosting guide says what it takes.
Download the export of our demo project, shop. It is the same zip the Eject button gives you, with the chart, the values and the build script. If you do not like what is inside, do not sign up.