Images build and configure supporting data services such as databases, caches, job queues, etc. They are Docker images that include scripts unique to Nanobox.

Finding Images

Nanobox provides images for many different services and technologies. You can view the official Nanobox Images on Docker Hub.

If you can't find an image to suit your needs, you can create your own. In the future, there will be a registry where you can search for and publish images.

Using an Image

Images are specified in the data components sections of your boxfile.yml. Images are used to provision and configure your data services. Image specifications should also include a version for the service, which is appended to the image path with a colon (:). Versions are optional, but recommended.

Specifying an Image in Your boxfile.yml

  image: nanobox/postgresql:9.5

Note: Only images published on Docker Hub can be used with Nanobox. If you want to use your own image, use the following pattern:

  image: dockerhub-username/repo-name

Setting Image Configuration Options

Images often include configuration options allowing you to customize your service to your specific needs. Each image should include documentation for available config options. These options are set in the data > config section of your boxfile.yml.

Setting Engine Config Options in Your boxfile.yml

  image: nanobox/mysql:5.6
      - federated
      - audit_log
    event_scheduler: 'Off'

Creating Images

You're free to create your own image if you can't find one that suits your needs. The Creating a Custom Image docs cover the process in detail.

Reach out to and we'll try to help.