Developer documentation
This section covers what you need to publish an application on the Clouve marketplace, from the platform architecture through submitting your first app.
The developer journey
1. Understand the platform → 00-platform-overview.md
2. Get access & onboard → 01-onboarding.md
3. Verify requirements → 02-application-requirements.md
4. Package with Docker → 03-containerization.md
5. Configure containers → 04-container-configuration.md
├─ Environment variables → 05-environment-variables.md
├─ Health checks → 06-health-checks.md
└─ Persistent storage → 07-volumes-storage.md
6. (Optional) Build a bundle → 08-bundles.md
7. Publish to marketplace → 09-publishing.md
8. Troubleshoot issues → 10-troubleshooting.md
9. (Optional) AI Assistant → 11-magneto-agent.md
Documents in this section
| # | Document | What it covers |
|---|---|---|
| 0 | Platform overview | Architecture, services, how deployments work end-to-end |
| 1 | Onboarding | Developer account, access, tooling prerequisites |
| 2 | Application requirements | Technical checklist before you can submit |
| 3 | Containerization guide | Dockerfile, docker-compose.yml, and clv-docker-compose.yml |
| 4 | Container configuration | Step-by-step UI and YAML workflows |
| 5 | Environment variables | All 8 variable types with examples |
| 6 | Health checks | HTTP, TCP, and Command health check configuration |
| 7 | Volumes and storage | Persistent volume setup and sizing |
| 8 | Bundles | Multi-app marketplace listings |
| 9 | Publishing | Submission, review, versioning, updates |
| 10 | Troubleshooting | Common errors and diagnostic steps |
| 11 | Magneto Agent / AI Assistant | Optional platform-synthesized agent sidecar |
Key concepts
Application: a single deployable unit made of one or more containers, such as a WordPress app that includes the WordPress container and a MariaDB container.
Bundle: a marketplace listing that contains multiple independent public-facing apps with shared infrastructure, such as an Education Kit combining Moodle and Gibbon.
Marketplace Manifest (clv-docker-compose.yml): the configuration file that describes your app to the Clouve platform. It extends a standard Docker Compose file with x-clouve-* metadata fields.
Container Configuration: the process of defining each container's resources, environment variables, health checks, and storage, either through the web UI or by uploading a Docker Compose YAML file.
Clouve Platform: the internal Kubernetes manifest generator. It reads your container configuration and produces the K8s resources needed to deploy your app to any supported cloud.
Prerequisites
Before working through these docs, you need:
- Docker installed and working locally
- Familiarity with Docker Compose
- A containerized application, or one in progress
- A Clouve developer account (see Onboarding)