ConvoyDocs

Welcome to Convoy Cloud

Deploy web applications without managing infrastructure.

What is Convoy Cloud?

Convoy Cloud is a Platform-as-a-Service (PaaS) that lets you deploy web applications directly from your GitHub repositories — no servers to provision, no Kubernetes to learn, no infrastructure to manage.

Push your code and Convoy Cloud handles the rest: building container images, deploying to a managed cluster, issuing TLS certificates, routing traffic, and monitoring your applications.

What is in the alpha

The alpha ships three products:

  • Convoy Apps — deploy web applications from GitHub source code or an existing container image. Supports Dockerfile builds, buildpack auto-detection, custom domains, environment variables, health checks, and auto-deploy on push.
  • Convoy Observability — a Grafana workspace scoped to your organization, provisioned automatically. Pre-built dashboards for metrics (CPU, memory, network), logs (Loki), and resource usage. No setup required.
  • Convoy Audit — a full activity timeline for your workspace. Every deployment, app change, member action, GitHub push, billing event, and alert in one searchable feed.

Functions and Databases are in development and will ship after the alpha.

How it works

  1. Connect your GitHub account — install the Convoy Cloud GitHub App and authorize your repositories.
  2. Create a deployment — pick a repo, branch, and commit. Choose between a Dockerfile build, buildpack auto-detection, or an existing container image.
  3. Convoy Cloud builds and deploys — your code is built into a container image, stored in a private registry, and deployed to an isolated Kubernetes namespace.
  4. Your app is live — accessible at a *.convoy-tech.com URL with TLS, or on your own custom domain.

Key features

  • Two build methods — Dockerfile for full control, or buildpacks for zero-config builds that auto-detect your language and framework.
  • Existing image deploys — bring a pre-built image from Docker Hub or GitHub Container Registry and deploy it directly.
  • Live build logs — watch your build and deployment progress in real time.
  • Auto-deploy — redeploy automatically on every push to a branch.
  • Custom domains — point your own domain with automatic TLS certificates provisioned by Let's Encrypt.
  • Per-app resource control — configure CPU, memory, and replica count per application.
  • Persistent storage — each app has a persistent volume mounted at /data.
  • Observability — application metrics, logs, and resource dashboards in a dedicated Grafana workspace. Open it from Observability in the sidebar.
  • Audit — complete activity timeline for your workspace. Open it from Audit in the sidebar.
  • Team workspaces — invite members, manage deployments collaboratively.
  • Pay-as-you-go billing — billed in EUR based on actual CPU and memory usage. New accounts receive welcome credits.

Supported languages and frameworks

When using buildpacks, Convoy Cloud auto-detects and builds applications for:

  • Node.js (Express, Next.js, Remix, Fastify, and others)
  • Python (Django, Flask, FastAPI, and others)
  • Go
  • Java (Spring Boot, Maven, Gradle)
  • Ruby (Rails, Sinatra)
  • PHP (Laravel, Symfony)
  • .NET
  • Rust
  • Static sites (HTML/CSS/JS)

When using a Dockerfile, you can deploy anything that runs in a container.

Next steps