Hosting farmOS with Docker

Docker is an open-source project that automates the deployment of applications inside software containers. - Wikipedia

A farmOS Docker image is available on Docker Hub at This image contains the farmOS codebase with all dependencies.

It does not include the database server, but that can be set up separately as a standalone service, or in another Docker container.

Development environment

The farmOS Docker image can be used in both development and production environments. However, a separate dev Docker image is available for development purposes. See Developing farmOS with Docker for instructions on setting up a development environment.

Production environment

If you plan to host farmOS in a production environment with Docker, it is assumed that you have experience with Docker in production already and will make decisions about how to fit it into your specific server environment. An example docker-compose.production.yml file is provided in the farmOS repository's docker directory which demonstrates the basics. You can copy and rename this to docker-compose.yml as a starting point.

When new versions of farmOS are released, they are tagged on Docker hub. The latest tag is also used to point to the most recent stable release tag, although using this to automatically update is not recommended unless you also have a plan for running update.php with each update.

Updating farmOS

General instructions for updating to a new version of farmOS are described in the Updating farmOS docs. It is important to familiarize yourself with that process before considerring how to do it with Docker.

Updating farmOS hosted with Docker (assuming that you are using the example docker-compose.production.yml configuration as an example) is roughly the same process, with a few exceptions:

With /var/www/html/sites mounted as a volume, you can simply update to a new version of the farmOS Docker image itself and then run update.php to update farmOS.