Hosting farmOS with Docker¶
It does not include the database server, but that can be set up separately as a standalone service, or in another Docker container.
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.
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
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.
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:
- Steps 2 and 3 (downloading and unpacking the new version) are performed automatically during the Docker image build process.
- The farmOS codebase is built into the Docker image in
/var/www/html, and the site-specific settings and files are mounted in as a volume in
/var/www/html/sites, so they persist outside of the container.
- Drush is not installed in the farmOS Docker image. You can create a derivative
image that includes Drush, if necessary. The farmOS development image does
this, so you can look at
docker/dev/Dockerfilein the farmOS repository as an example.
/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
Customizing php.ini settings¶
It is common to need to customize certain PHP settings - such as the max upload size limit. This can be easily accomplished via a custom php.ini file mounted in the farmOS docker container.
volumes: - './php-custom.ini:/usr/local/etc/php/conf.d/php-custom.ini'
upload_max_filesize = 10M post_max_size = 10M
See the PHP configuration file documentation for more details on php.ini files.