Skip to main content
Already push a Docker image for your app? Run it on a pod as it is. InstaPods pulls the image, runs its own ENTRYPOINT and CMD, routes your pod’s HTTPS URL to the port it exposes, and keeps the previous version on hand for an instant rollback. No Dockerfile changes and no build step.
Or open Import → Docker image in the dashboard (/dashboard/import?tab=image).
This runs images you have already built. Building a Dockerfile from your repository is not supported yet.

What works

How your image runs

  • Command. The image’s own ENTRYPOINT + CMD, exactly as Docker would run them, in the image’s WORKDIR, as the image’s USER (root when it sets none).
  • Port. We route your URL to the port the image EXPOSEs. When it exposes several, an HTTP-ish one wins over SSH or database ports. With no EXPOSE, the app gets PORT=8080. If the app ignores PORT and listens on a port of its own, the deploy finds that port at the end of its 2-minute wait and routes it. To pick the port yourself: --port 3000 (CLI) or the Port field in the dashboard.
  • Environment. The image’s own ENV values, then PORT and HOST=0.0.0.0, then the variables you set (instapods env set, or the Env tab), which win over the image’s.
  • Data. The pod’s persistent paths are kept in /home/instapod/data, survive every redeploy and rollback, and are backed up. Anything the app writes outside them is replaced on the next deploy, as it would be with Docker. See Keep your app’s data.
  • Databases. A managed PostgreSQL, MySQL or Redis runs in the same pod, and the app reaches it at 127.0.0.1. Pick one when you create the pod (the Add a managed PostgreSQL database box in the dashboard) and DATABASE_URL / REDIS_URL are set for you. Added later with instapods services add, it is not: set the URL yourself with instapods env set. Connect over TCP; Unix sockets aren’t shared with the app.
  • Logs. Everything the app prints is in the Logs tab and instapods logs <pod>.
  • Health. A deploy only switches over once the new version answers HTTP (it waits up to 2 minutes, for slow starters like the JVM). If it never does, the previous version keeps serving and the deploy log says why.

Keep your app’s data

A pod’s persistent paths are, together:
  • the paths the image declares as VOLUME,
  • InstaPods defaults for popular images that declare none (today that is ezBookkeeping: /ezbookkeeping/data and /ezbookkeeping/storage),
  • the paths you add yourself.
Plenty of images keep a SQLite database or uploads in a directory they never declare. When an image gives the pod no persistent paths at all, every deploy log says so, the pod gets a warning event, and the Image tab shows it. Add the app’s data directory and deploy:
Repeat --volume for several paths. Passing it replaces the pod’s list; --volume "" clears it, and leaving it out keeps the list you have. Needs CLI v1.17.0 or later.
Data the app already wrote in a path you add is normally copied into it by that deploy, and the version that was running stays on the pod as the rollback target. Paths must be absolute (start with /), up to 10 per pod; a path the image doesn’t have yet starts as an empty directory. Whole system directories (/usr, /etc, /var, /opt and the like) and paths InstaPods uses itself (/tmp, /run, /home/instapod/app) are refused; name the directory the app writes its data to, such as /var/lib/myapp.

Redeploy, change the tag, roll back

The pod’s Image tab does the same, and lists every deploy. Roll back on the previous version is instant: it is still on the pod, so nothing is downloaded. A version that ran before you added a persistent path is downloaded again instead, so it reads its data from the kept path rather than an old copy.

Inside the pod

SSH and the web terminal land in the pod as usual. Your image’s files are at /opt/instapods/rootfs/current; to get a shell inside them, run sudo chroot /opt/instapods/rootfs/current sh (if the image has a shell).

Not supported yet

  • Private images that need a registry login.
  • Building from a Dockerfile or docker-compose.yml, and running several services from one.
  • HEALTHCHECK, more than one routed port, UDP.
  • Anything that needs extra privileges at runtime (--privileged, --cap-add, mounting filesystems, the Docker socket).
  • linux/arm64-only images.

When a deploy fails

The deploy log ends with what went wrong and what to do. The common ones: