General
What is a pod?
What is a pod?
A pod is a persistent Linux container running on InstaPods infrastructure. Think of it as a lightweight virtual server with its own filesystem, SSH access, and public URL. Unlike Docker containers, pods are persistent — all data survives restarts.
How long does it take to create a pod?
How long does it take to create a pod?
Pods are created in 1–2 seconds using pre-built images. If the warm pool is enabled in your region, creation can be nearly instant.
Can I run multiple apps in one pod?
Can I run multiple apps in one pod?
Technically yes — a pod is a full Linux container, so you can run multiple processes. However, each pod is designed around a single preset (Static, PHP, Node.js, or Python). For multiple apps, we recommend separate pods.
Are pods ephemeral like Docker containers?
Are pods ephemeral like Docker containers?
No. Pods are persistent containers — all files, installed packages, and configurations survive stop/start cycles. Your data is preserved unless you explicitly delete the pod.
What Linux distribution do pods use?
What Linux distribution do pods use?
All pods run Ubuntu 24.04 LTS (Noble Numbat).
SSH & Access
How do I connect to my pod via SSH?
How do I connect to my pod via SSH?
Each pod has a dedicated SSH port. Find it on the pod detail page or run Or use the CLI shortcut:
instapod pods get my-app. Then connect:instapod ssh my-appCan I use my own SSH key?
Can I use my own SSH key?
Yes. Add your public key at pod creation (
--ssh-key flag), via the dashboard SSH tab, or with the CLI:What user do I connect as?
What user do I connect as?
Always connect as the
instapod user. This is the non-root user that owns your application files.Services & Databases
Why can't I install services on the Starter plan?
Why can't I install services on the Starter plan?
Database services (MySQL, PostgreSQL, Redis) require additional memory and CPU. The Starter plan’s resources (512 MB RAM, 1 vCPU) are too limited for reliable database operation. Upgrade to the Developer or Professional plan.
Can I access my database from outside the pod?
Can I access my database from outside the pod?
No. Database services listen on
localhost only and are not accessible from the internet. This is a security measure. To access your database remotely, use SSH port forwarding:How do I back up my database?
How do I back up my database?
SSH into your pod and use the database’s native dump tool:Then download the dump file using SCP or the CLI.
Billing
What happens if my payment fails?
What happens if my payment fails?
Your subscription enters a “past due” state with a 7-day grace period. During this time, existing pods keep running but you can’t create new ones. After 7 days, pods are suspended. Pay the invoice to reactivate.
Can I change plans?
Can I change plans?
Yes, upgrade or downgrade anytime from the billing page. Changes take effect at the next billing cycle.
Do stopped pods cost money?
Do stopped pods cost money?
Currently, billing is per-plan (flat monthly rate), not per-usage. A stopped pod still counts toward your subscription. Delete the pod if you no longer need it.
Custom Domains
How many custom domains can I add?
How many custom domains can I add?
Up to 5 custom domains per pod.
Do I get SSL for custom domains?
Do I get SSL for custom domains?
Yes. After DNS verification, an SSL certificate is automatically provisioned via Let’s Encrypt.
Can I use a root domain (not a subdomain)?
Can I use a root domain (not a subdomain)?
Yes, if your DNS provider supports CNAME flattening (most modern providers do, including Cloudflare). Otherwise, use a subdomain like
app.example.com.