Build on Dekka
Guides and reference for deploying applications, adding databases and storage, and using the API.
Deploy your first appFrom a GitHub repository to a running URL in a few minutes.API referenceEvery request, with examples you can paste straight into a terminal.Connect a databaseWhat happens when an app and PostgreSQL are joined.SecurityHow accounts, secrets and workloads are protected.
Start
- Getting startedSign in, create a project, deploy a service from GitHub and connect it to PostgreSQL.
- Projects and environmentsHow projects, regions and environments organise your services, and how to create, fork, switch and delete environments.
- Staged changesCollect settings changes in an environment and deploy them together, so related edits land at the same time.
Services
- Deploying from GitHubConnect the Dekka GitHub App, choose a repository and branch, and deploy on every push.
- Deploying a Docker imageRun a prebuilt image from Docker Hub, GitHub Container Registry or any other registry, including private images.
- Web services, workers and cron jobsChoose how a service runs, as a web service on a port, a worker in the background, or a cron job on a UTC schedule.
- Build and deploy settingsEvery setting that controls how a service is built, started, checked, restarted and sized.
- Config as codeKeep a service's settings in dekka.toml or dekka.json next to its code, and describe a whole environment in a dekka.yaml blueprint.
- VariablesSet service and shared variables, reference one service's values from another, keep secrets sealed, and read the variables Dekka provides.
- DeploymentsFollow a deployment through its states, redeploy, roll back, cancel or remove one, and find out when one fails.
- VolumesAttach a disk to a service so files survive deploys and restarts, and grow it when it fills up.
Data
- ConnectionsConnect a service to PostgreSQL, Redis or a bucket, and the variables each connection sets.
- PostgreSQLCreate a PostgreSQL database, connect services to it, browse and query it, and reach it from your own machine.
- RedisCreate a Redis database for caching, queues and sessions, and choose its memory, eviction policy and persistence.
- Object storageCreate a private S3-compatible bucket for uploads and files, and use it from a service with the AWS SDK.
- QueuesCreate a managed message queue for workers and scheduled jobs, choose how long it hides and keeps messages, and connect services to it.
- BackupsHow Dekka backs up PostgreSQL databases and volumes, where the backups are kept, and how to restore one.
AI
- AI GatewayCall OpenAI and Anthropic models through one OpenAI-compatible endpoint, stream replies, and see which model answered.
- AI keysUse your own OpenAI and Anthropic keys, create gateway keys for your code, choose a project per request, and connect a service to the AI Gateway on the canvas.
- Routing rulesChoose which providers and models a project may use, the order to fall back in and a monthly spend cap, and see the order the gateway checks each request in.
- Models and usageSee which models the AI Gateway offers and their list prices, what Not available means, and follow each request and your spend over time.
Servers
- Virtual serversCreate a Linux server with root access over SSH, start, stop, resize, rebuild and delete it, and see how it's billed and how many you can have.
- SSH keysAdd the public keys Dekka installs on new virtual servers, check their fingerprints, and fix a key Dekka refuses.
- GPU instancesSee the GPU instances Dekka plans to offer, join the waitlist, and request a private inference endpoint you can call through the AI Gateway.
Networking
- Public addresses and custom domainsThe HTTPS address every web service gets on apps.dekka.cloud, and how to point your own domain at a service.
- Private networkingReach other services in the same environment by name on dekka.internal, without going over the internet.
- TCP proxyGive a PostgreSQL or Redis database a public host and port so you can connect from your own machine.
Observability
- LogsRead a service's runtime output and HTTP request logs, search build, deploy and job output, and fetch logs from the API.
- MetricsChart a service's CPU, memory, network, disk, request rate and response time over the last hour to the last seven days.
- Deploy webhooksGet a signed HTTP request when a deploy starts, succeeds or fails or a service crashes, verify it, and handle retries, tests and redelivery.
Account
- Signing inSign in to Dekka with an email link, GitHub, Google or a passkey, and manage your sign-in methods and sessions.
- Organisations and membersWhat an organisation holds, the four member roles, inviting teammates, changing roles and removing members, and where to see your organisation's activity.
- API keysCreate an API key for scripts and CI, choose what it can do, and call the Dekka API with it.
- Project tokensCreate a token that reaches only one project, and deploy from GitHub Actions or another CI system with it.
- Registry credentialsStore a username and token for a private container registry so Dekka can pull your private images.
- Plans, billing and usageChange plans, pay with a card or mobile money through Paystack, understand metered usage and invoices, and set spending alerts and a spend limit.