deplaneDocs Dashboard

Limits

Every limit that applies to your apps, builds, and account, in one place.

Plan limits come from your organization's plan. They are plan settings, not fixed rules, and they can change. Run deplane whoami --json to see the limits that apply to you right now. To see what you used against them, open Usage in the dashboard or run deplane usage; see Dashboard. To raise a limit, email support@deplane.cloud.

Requests to your app

LimitValue
Request body100 MB per HTTP request to an app.
Time to the first response byte125 seconds. If your app sends nothing for 125 seconds after a request arrives, the request fails with a timeout. Send long work to a background job, or stream the response.
WebSocketsSupported, with no extra configuration. Connections stay open as long as data flows. Long-idle connections may be closed, so reconnect when that happens.
HTTPSEvery app gets https://NAME.deplane.dev with a certificate, set up for you.
Large mediaDeplane is not a host for large video or file downloads. Use a storage service for those.

Instance sizes

SizeCPUMemory
small (default)0.5 vCPU512 MB
medium1 vCPU1 GB
large2 vCPU2 GB

Every instance of an app has the same size. Change it with deplane scale --size medium.

An autoscaled app counts at its maximum instances, whether or not it runs that many, and a sleeping app counts too.

Beta plan

LimitBeta planError when you reach it
Memory, all instances of all apps together1536 MBlimit_memory
Apps3limit_apps
Instances, all apps together3limit_instances
Sizessmall, medium, largelimit_size
Build time300 build minutes per month, reset on the 1st (UTC)limit_build_minutes
Builds at the same time1; more builds wait in the queuenone, they wait
Log retention7 daysnone
Database backupsKept 7 days (point-in-time restore to any second in them)none
Live log streams at the same time3limit_log_streams
App disk space, all disks together10 GB (two 5 GB disks)limit_disk
Redis1 (256 MB memory each, counted in your memory)limit_redis

For example, one large instance (2048 MB) does not fit in 1536 MB, but one medium and one small instance (1536 MB) do. Three small instances use 1536 MB too.

Errors for plan limits have codes that start with limit_, and the CLI exits with code 6 for them.

Besides your plan's limits, Deplane refuses a new app, a preview, a scale-up, a new or bigger worker or cron job, a new or restored database, a new Redis, or a template deploy while its servers are nearly full (above 85% of their memory reserved), with capacity_full. Running apps keep running; try again later.

Redis

LimitValue
Size256 MB memory (200 MB of data), 1 GB storage
Redis per app1. See redis_attached_elsewhere.
Back up nowOnce an hour per Redis. See backup_too_soon.
BackupsNightly; kept 3 days (or your plan's backup window, if shorter), plus the newest that worked; off-site, 7 days.

See Redis.

Uploads and builds

LimitValue
Upload size100 MB compressed.
Project size2 GiB uncompressed.
Files200,000 files and folders.
Dockerfile1 MB. A # syntax= line is not allowed.
Uploads at the same time2 per organization.
Build time15 minutes per build.
Build memory3 GB.
Build disk10 GB.
Image layer2 GB compressed per layer.
Queue timeA build that waits in the queue for more than 1 hour expires. Run deplane deploy again.
Build logsKept 30 days.

The CLI never uploads the .git folder or .env files. It honors .gitignore and .dockerignore. Keep node_modules, build output, and large data files out of the upload with them.

Releases and rollout

LimitValue
Time for a release to become healthy5 minutes. After that the release fails with Timeout and the previous release keeps serving.
StartupAn instance has up to 2 minutes to start answering its health check.
Releases shown by deplane releasesThe newest 50.

Databases

LimitValue
Databases per team5. See too_many_databases.
Disk per database10 GB.
Sizesmall, medium, or large; a database counts against your plan as one instance of its size.
Databases per app1, as DATABASE_URL.
Backup windowYour plan's: 7 days on the Beta plan. Restore to any second in it, up to about a minute ago.
Deleted databasesRestorable for the backup window, then deleted for good with their backups.
Preview databases3 per team at a time, smallest size, free (they do not count toward the 5 or your plan). Never backed up.

See Databases.

App disks

LimitValue
Disks per app1, of 5 GB. See disk_exists.
Disk space per teamYour plan's: 10 GB on the Beta plan. See limit_disk.
Instances of an app with a disk1, without autoscaling. See disk_needs_one_instance.
Back up nowOnce an hour per disk. See backup_too_soon.
Disk backupsNightly. Disk backups are kept 3 days (or your plan's backup window, if shorter), plus the newest that worked; off-site, 7 days.

See Disks.

Apps, previews, domains, and processes

LimitValue
Pull request previews3 per app at a time. They count toward your plan's apps and instances.
Custom domains10 per app.
Workers and cron jobs10 per app; a worker runs 0 to 20 instances.
Instances of one appUp to your plan's instance limit. The autoscale maximum is 1 to 1000, also bound by your plan. The AI tools' scale tool takes at most 20 for instances.
Sleep when idleAfter 5, 15, or 60 minutes without requests, or never.
Automatic rollbackWatches a release for its first 10 minutes live. Needs at least 50 requests and 10 errors from the app (502, 503 and 504 do not count), reaching visitors on at least 3 networks.
Alert channels10 per team.

Logs

LimitValue
deplane logsThe last 100 lines of each running instance by default.
deplane logs --tail NUp to 1000 lines per instance.
Live stream (deplane logs -f)Up to 30 minutes per stream; run it again to continue.
Live streams at the same timeSet by your plan: 3 on the Beta plan. A deploy that follows its build log uses one too.

Rate limits

WhatLimit
Login, sign-in links, and second-factor attempts5 per minute per IP address and per email
Access requests and abuse reports3 per hour per IP address
API requests120 per minute per token
Deploys10 per hour per app
Live log streams3 per organization at the same time

When you hit a rate limit, the API answers HTTP 429 with rate_limited and a Retry-After header. Wait and try again.

API

LimitValue
Request body64 KB, except source uploads (100 MB).
CLI login tokenLasts 30 days.
CI token90 days by default, at most 365 days.
Login code (deplane login)Expires after 10 minutes.
Fresh passkey confirmationValid for 5 minutes.

App names

Secrets

LimitValue
NameCapital letters, digits, and underscores; not starting with a digit; at most 128 characters.
Reserved namesPORT and names that start with DEPLANE_.
One value32 KB.
All values of one app, per kind (runtime or build)256 KB.

Network from your app

Your app can reach the internet. Some destinations are blocked for everyone:

Regions

Apps run in one region today: fra (Germany).

This page is also available as Markdown. AI agents can start at /llms.txt.