# Lucity

> Open-source PaaS on Kubernetes with full ejectability. Git push to deploy, environments out of the box, and a real exit door.

## Documentation Sets

- [Lucity](https://lucity.cloud/llms-full.txt)

## Docs

- [Basic Concepts](https://lucity.cloud/raw/getting-started/concepts.md): Understand the core building blocks of the Lucity platform
- [About Lucity](https://lucity.cloud/raw/getting-started/about.md): The story behind the project, who built it, why, and how
- [Self-Hosting](https://lucity.cloud/raw/getting-started/self-hosting.md): Deploy Lucity on your own Kubernetes cluster with TLS and production-ready routing
- [Roadmap](https://lucity.cloud/raw/getting-started/roadmap.md): Where Lucity is headed, organized by priority instead of deadlines
- [Projects](https://lucity.cloud/raw/features/projects.md): Create and manage projects: the top-level container for your services and environments.
- [Scaling](https://lucity.cloud/raw/features/scaling.md): Scale services manually or automatically with horizontal pod autoscaling.
- [Billing & Pricing](https://lucity.cloud/raw/features/billing.md): Plans, resource pricing, and the self-hosting alternative.
- [Services](https://lucity.cloud/raw/features/services.md): Auto-detect and manage deployable units within your project.
- [Environments](https://lucity.cloud/raw/features/environments.md): Manage deployment targets from development to production.
- [Builds](https://lucity.cloud/raw/features/builds.md): Build container images from your source code automatically.
- [Deployments](https://lucity.cloud/raw/features/deployments.md): Deploy your services to Kubernetes with real-time feedback.
- [Promotion](https://lucity.cloud/raw/features/promotion.md): Promote images between environments without rebuilding.
- [GitHub Integration](https://lucity.cloud/raw/features/github-integration.md): Connect your repositories and automate deployments via webhooks.
- [Eject](https://lucity.cloud/raw/features/eject.md): Export your entire setup as standard Helm charts and ArgoCD configs.
- [Environment Variables](https://lucity.cloud/raw/features/variables.md): Configure your services with shared variables, service variables, database refs, and service refs.
- [Databases](https://lucity.cloud/raw/infrastructure/databases.md): Provision PostgreSQL databases with CloudNativePG
- [Redis](https://lucity.cloud/raw/infrastructure/redis.md): Add Redis instances for caching and session storage
- [Cron Jobs](https://lucity.cloud/raw/infrastructure/cron-jobs.md): Run scheduled tasks on a cron schedule
- [Networking](https://lucity.cloud/raw/infrastructure/networking.md): Configure public routing, domains, and internal service discovery
- [Philosophy](https://lucity.cloud/raw/architecture/philosophy.md): The principles that guide every design decision in Lucity
- [How It Works](https://lucity.cloud/raw/architecture/how-it-works.md): A technical deep-dive into Lucity's architecture
- [GitOps](https://lucity.cloud/raw/architecture/gitops.md): How Lucity uses Git as the source of truth for deployments
- [Overview](https://lucity.cloud/raw/security/overview.md): How Lucity isolates workloads, protects the platform, and keeps your infrastructure secure
- [Build Isolation](https://lucity.cloud/raw/security/build-isolation.md): How Lucity isolates build workloads from platform components
- [Network Policies](https://lucity.cloud/raw/security/network-policies.md): How Lucity restricts network traffic between workloads and platform components
- [Pod Security](https://lucity.cloud/raw/security/pod-security.md): Security contexts, seccomp profiles, and container hardening
- [Registry Authentication](https://lucity.cloud/raw/security/registry-auth.md): How container image registry credentials are scoped and managed
- [Agencies](https://lucity.cloud/raw/use-cases/agencies.md): Deploy client projects with confidence, and hand them over cleanly
- [Startups & Small Teams](https://lucity.cloud/raw/use-cases/startups.md): Railway simplicity today, Kubernetes freedom when you're ready
- [Platform Teams](https://lucity.cloud/raw/use-cases/platform-teams.md): Give your developers a PaaS experience on your own Kubernetes cluster
- [PaaS Comparison: Lucity vs Railway, Render, Heroku, Fly.io, Coolify](https://lucity.cloud/raw/comparisons/overview.md): See how Lucity compares to Railway, Render, Heroku, Vercel, Fly.io, and Coolify. Open-source, ejectable, self-hostable Kubernetes PaaS.
- [Lucity vs Railway: Open-Source Railway Alternative](https://lucity.cloud/raw/comparisons/vs-railway.md): Compare Lucity and Railway. Same deploy experience, but open-source, self-hostable, and ejectable to standard Kubernetes.
- [Lucity vs Render: Open-Source Render Alternative](https://lucity.cloud/raw/comparisons/vs-render.md): Compare Lucity and Render. Both simple to use, but Lucity is open-source, self-hostable, and ejectable to standard Kubernetes.
- [Lucity vs Heroku: Open-Source Heroku Alternative](https://lucity.cloud/raw/comparisons/vs-heroku.md): Compare Lucity and Heroku. Modern Kubernetes-native PaaS with ejectability, open-source, and no Salesforce tax.
- [Lucity vs Vercel: Full-Stack Vercel Alternative](https://lucity.cloud/raw/comparisons/vs-vercel.md): Compare Lucity and Vercel. Vercel excels at frontend, Lucity handles the full stack with databases, workers, and ejectability.
- [Lucity vs Fly.io: Open-Source Fly.io Alternative](https://lucity.cloud/raw/comparisons/vs-fly-io.md): Compare Lucity and Fly.io. Fly.io runs apps at the edge on custom hardware. Lucity is open-source, self-hostable, and ejectable to standard Kubernetes.
- [Lucity vs Coolify: Open-Source PaaS Comparison](https://lucity.cloud/raw/comparisons/vs-coolify.md): Compare Lucity and Coolify, two open-source PaaS platforms with fundamentally different architectures. Docker Compose simplicity vs Kubernetes ejectability.
- [Workspaces, Billing, Scaling, Custom Domains, Variables](https://lucity.cloud/raw/changelog/continued-development.md): Features built since the initial development sprint.
- [Projects, Builds, Deployments, Environments, Databases, Ejection](https://lucity.cloud/raw/changelog/initial-development.md): Everything built during the first week, from empty repository to functional PaaS.
- [Changelog](https://lucity.cloud/raw/changelog.md): What's new in Lucity: features, improvements, and the occasional victory lap.
- [Data Processing Agreement](https://lucity.cloud/raw/legal/data-processing-agreement.md): How Lucity processes personal data on your behalf.
- [Privacy Policy](https://lucity.cloud/raw/legal/privacy-policy.md): How Lucity handles your data.
- [Terms of Use](https://lucity.cloud/raw/legal/terms-of-use.md): Terms governing your use of Lucity.

## Blog

- [The European open-source alternative to Vercel, Heroku, and Railway](https://lucity.cloud/raw/blog/european-open-source-alternative-to-vercel-heroku-railway.md): Why I built Lucity: the same developer experience as Vercel, Heroku, and Railway, on an open platform you own and can leave at any time.
- [The Software Deployment Trilemma](https://lucity.cloud/raw/blog/the-software-deployment-trilemma.md): There seems to be a trilemma in software deployment solutions that says: Scalable, Simple, Sovereign — pick two.