Raklane Documentation
Deploy and manage your applications on Raklane — guides for getting started, deploying, environment variables, custom domains, teams, and more.
Raklane is a Platform as a Service (PaaS) that runs on your own server. Connect a VPS you already rent with one command — that's Bring Your Own Compute (BYOC) — and deploy straight from a Git repository (or an uploaded archive). Raklane builds a container image, runs it on your server, health-checks it, and routes traffic to it over HTTPS. You keep the server. Raklane runs the platform.
Raklane Cloud is coming soon. Servers run by Raklane — pay-as-you-go apps, dedicated plans and managed databases — aren't open yet. Pages that cover them are marked. Everything else works today on a server you bring.
This documentation is written for people using Raklane to deploy and run apps — not for people building Raklane itself. Start here:
New here?
- Getting Started — create an account, connect your server, and deploy your first app in a few minutes.
- Core Concepts — the handful of terms (App, Project, Build, Release, Domain, Cluster) that make everything else easier to follow.
- How Raklane Works — the end-to-end journey from your code to live traffic.
- Security & Architecture — how the agent connects, what it can access, how secrets are stored, and who manages what.
- Raklane Compared — how Raklane differs from a bare VPS, a server panel and a managed app platform, and when another tool fits better.
- Why “Raklane”? — where the name comes from.
Bring Your Own Compute (BYOC)
Run your apps and databases on servers you own, with a full platform on top.
- BYOC: Overview & How It Works — architecture, security model, and what happens when things fail.
- Setting Up a BYOC Server — requirements, registration, and the one-line install.
- Running Apps & Databases on BYOC — deploying, default URLs, custom domains, HTTPS, databases.
- Managing BYOC Servers — statuses, connection checks, agent updates, maintenance, decommissioning.
- BYOC Agent Configuration — the agent's settings file and every environment variable it reads.
- BYOC Billing — the management fee and what happens if your wallet runs low.
- BYOC Troubleshooting — fixes for the most common BYOC problems.
Deploying apps
- Deploying Your App — connecting a Git repo or uploading an archive, triggering a deploy, replicas, resource limits, rollbacks.
- Where Your App Runs — your own server today; PAYG and Dedicated clusters when Raklane Cloud opens.
- Secrets — connecting a private repository and other credentials your deploys need.
- Auto-Deploy & Deploy Modes — have a
git pushtrigger a deploy automatically. - Environment Variables — configuring your app at runtime.
- Custom Domains — pointing your own hostname at an app, and how HTTPS gets issued.
- Databases — provisioning a Postgres or MySQL database for your project.
Managing your app
- Logs & Status — checking whether a deploy succeeded and reading your app's output.
- Metrics & Processes — CPU, memory, network, and disk usage live and over time, sizing hints, and live process lists.
- Managing Your App — pausing, resuming, and deleting apps and projects; static sites vs. regular apps.
Teams
- Teams & Organizations — inviting teammates, roles and permissions, and seats.
- Billing & Wallet — prepaid credit, the BYOC management fee, and Raklane Cloud pricing.
Help
- Troubleshooting — fixes for the problems you're most likely to actually hit.
- FAQ — quick answers to common questions.