✨ Announcing Render's $50M Series B. ✨

Deploy prebuilt Docker images to Render

By Stephen Barlow

Render takes your infrastructure problems away and gives you a battle-tested, powerful, and cost-effective cloud with an outstanding developer experience. Focus on building your apps, shipping fast, and delighting your customers, and leave your cloud infrastructure to us.

Hey, cool news: Render now supports deploying a Docker image directly from a container registry! If you already build and push Docker images in CI, your Render services no longer need to spend time also building those same images. This can significantly speed up your Docker-based deploys 🚀

What it looks like

When you create a new Render service from your dashboard, we now ask whether you want to deploy from a Git repo or a container registry:

Choosing a deploy method in the Render Dashboard

You can deploy a public image from any registry, and you can deploy your private images from Docker Hub, GitHub, or GitLab by adding your credentials:

UI for specifying a Docker image URL and credentials

When you provide your Docker image’s URL, you can specify either a particular tag (such as latest above), or a digest like so:

docker.io/library/nginx@sha256:72099b46456fbd58481cbf842f22fd0030eb5bd1739de2ff8cff903180b76710

A digest always targets the exact same image, whereas a tag might target new images over time. Use whichever strategy is right for you! You can change the tag/digest later.

Differences from Git-backed deploys

These new image-backed services behave almost exactly like your existing Git-backed services: you can scale them up and down, add a persistent disk, and set environment variables and secrets.

However, image-backed services do differ from Git-backed services in a couple of important ways:

  • Redeploys: Git-backed services automatically redeploy with changes to their associated branch. Image-backed services aren’t connected to a Git repo, so you instead trigger redeploys manually or programmatically. See redeploy options.
  • Build previews: Git-backed services can automatically generate (and later delete) preview instances for every opened pull request. To manage preview instances of an image-backed service, you use Render’s REST API.

Build it there, run it here

We’re happy to build your image from a Dockerfile, but we’re just as happy not to! With image-backed deploys, Render can slot into your existing build pipeline without needlessly duplicating work.

Excited to deploy your first image? Head over to your dashboard and check out the docs for all the extra details.

Stephen Barlow

Stephen Barlow creates developer content at Render.

Subscribe to our newsletter for regular product updates.

Discover More

  1. How Render Scaled Knative to Support 100k+ Free-Tier Apps

    As Render free-tier apps exploded in popularity, we needed to make the feature much more scalable. This work was our first step along that path.

    - Hieu Nguyen

  2. Render design doc: Reducing Free-tier networking footprint

    An in-depth supplement for the post 'How Render scaled Knative to support 100k+ Free-tier apps'

    - Hieu Nguyen

  3. Announcing Point-in-Time Recovery

    With Point-in-Time Recovery enabled for your Render PostgreSQL, if you and your team experience unexpected data loss, you can restore to a new database seeded with data from archiv…

    - Scott Numamoto