Pod Lifecycle
Pods have the following statuses:
| Status | Description |
|---|
running | Pod is active and accessible |
stopped | Pod is shut down but data is preserved |
creating | Pod is being provisioned |
error | Something went wrong during creation |
suspended | Pod is suspended due to billing issues |
Start / Stop / Restart
On the pod detail page, use the action buttons in the header to Start, Stop, or Restart your pod.
instapod pods stop my-app
instapod pods start my-app
instapod pods restart my-app
curl -X POST https://api.instapods.com/api/pods/my-app/start \
-H "Authorization: Bearer YOUR_TOKEN"
curl -X POST https://api.instapods.com/api/pods/my-app/stop \
-H "Authorization: Bearer YOUR_TOKEN"
curl -X POST https://api.instapods.com/api/pods/my-app/restart \
-H "Authorization: Bearer YOUR_TOKEN"
Stopping a pod preserves all files but terminates running processes. Any in-memory data not written to disk will be lost.
Resize
Change the CPU, memory, or disk allocation of a running pod.
instapod pods resize my-app --cpu 2 --memory 2GB --disk 20GB
--cpu, --memory, --disk) are required.curl -X POST https://api.instapods.com/api/pods/my-app/resize \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"cpu": 2, "memory": "2GB", "disk": "20GB"}'
Delete
Deleting a pod permanently removes the container and all its data.
Go to the pod detail page, click the delete button, and confirm.
# With confirmation prompt
instapod pods delete my-app
# Skip confirmation
instapod pods delete my-app -f
curl -X DELETE https://api.instapods.com/api/pods/my-app \
-H "Authorization: Bearer YOUR_TOKEN"
Deletion is irreversible. All files, databases, and configurations inside the pod will be permanently destroyed.
List Pods
Output shows a table with name, preset, plan, CPU, memory, disk, status, and domain. curl https://api.instapods.com/api/pods \
-H "Authorization: Bearer YOUR_TOKEN"
Get Pod Details
curl https://api.instapods.com/api/pods/my-app \
-H "Authorization: Bearer YOUR_TOKEN"
Reload Application
Restart the application service inside the pod without restarting the container itself. Useful after deploying new code.
instapod pods reload my-app
- Static: Reloads nginx
- PHP: Restarts nginx and PHP-FPM
- Node.js: Restarts the
app systemd service
- Python: Restarts the
app systemd service
