Skip to content

zaxbux/docker-wintercms

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Docker for Winter CMS

These docker build files are still a work in progress!

Here are some Dockerfiles for Winter CMS.

Building Images

The quickest way to build an image is with the following commands:

  • PHP 7.4 + FPM: make build-fpm
  • PHP 7.4 + FPM + Alpine: make build-fpm-alpine

Getting Started

By default, when the container starts, artisan winter:up is executed to complete migrations.

Note: If there is no database on the first run, a random password is generated by Winter. To reset the admin password, run docker exec -it <container_id> artisan winter:passwd admin or docker-compose exec <service> artisan winter:passwd admin.

A note about Alpine Linux

Be aware that the default UID/GID for the www-data user in alpine is 82 (whereas it is 33 under debian). If you're mounting host directories, you may need to chown 82:82 them first.

Commands

Winter

E.g. to change the default admin password:

docker-compose exec wintercms winter passwd

Artisan

E.g. to install a plugin:

docker-compose exec wintercms artisan plugin:install AuthorName.PluginName

Composer

Composer is available inside the image. E.g. to install the Builder plugin:

docker-compose exec wintercms composer require winter/wn-builder-plugin

Configuration

Most of the configuration can be set using environment variables, although for more advanced configurations you can mount your config directory to /var/www/html/config/docker. Each config option and it's defaults are documented in the config/wintercms directory.

Configuration Option Envionment Variable
app.debug APP_DEBUG
environment.default APP_ENV
app.name APP_NAME
app.key APP_KEY
app.url APP_URL
app.trustedHosts APP_TRUSTED_HOSTS
app.timezone APP_TZ
app.locale APP_LOCALE
cache.default CACHE_STORE (the redis store is configured to use a different connection than the queue)
cms.activeTheme CMS_ACTIVE_THEME
cms.edgeUpdates CMS_EDGE_UPDATES
cms.backendUri CMS_BACKEND_URI
cms.backendForceSecure CMS_BACKEND_FORCE_SECURE
cms.backendForceRemember CMS_BACKEND_FORCE_REMEMBER
cms.backendSkin CMS_BACKEND_SKIN
cms.disableCoreUpdates CMS_DISABLE_CORE_UPDATES
cms.disablePlugins CMS_DISABLE_PLUGINS (e.g.: October.Demo,Acme.Demo)
cms.assetCache CMS_ASSET_CACHE
cms.databaseTemplates CMS_DATABASE_TEMPLATES
cms.pluginsPath CMS_PLUGINS_PATH
cms.themesPath CMS_THEMES_PATH
cms.storage.*.disk CMS_*_DISK
cms.storage.*.folder CMS_*_FOLDER
cms.storage.*.path CMS_*_PATH
cms.convertLineEndings CMS_CONVERT_LINE_ENDINGS
cms.linkPolicy CMS_LINK_POLICY
cms.defaultMask.file CMS_DEFAULT_MASK_FILE
cms.defaultMask.folder CMS_DEFAULT_MASK_FOLDER
cms.enableCsrfProtection CMS_CSRF_PROTECTION
database.default DB_CONNECTION
database.sqlite.database SQLITE_PATH
database.(mysql|pgsql).host DB_HOST
database.(mysql|pgsql).port DB_PORT
database.(mysql|pgsql).database DB_DATABASE
database.(mysql|pgsql).username DB_USERNAME
database.(mysql|pgsql).password DB_PASSOWRD
database.redis.(default|cache).host REDIS_HOST
database.redis.(default|cache).port REDIS_PORT
database.redis.(default|cache).password REDIS_PASSWORD
database.redis.default.database REDIS_DB
database.redis.cache.database REDIS_CACHE_DB
mail.driver MAIL_DRIVER
mail.host MAIL_HOST
mail.port MAIL_PORT
mail.from.address MAIL_FROM_ADDRESS
mail.from.name MAIL_FROM_NAME
mail.encryption MAIL_ENCRYPTION
mail.username MAIL_USERNAME
mail.password MAIL_PASSWORD
queue.default QUEUE_CONNECTION
queue.connections.redis.queue REDIS_QUEUE
queue.failed.database DB_CONNECTION
session.driver SESSION_DRIVER
session.lifetime SESSION_LIFETIME
session.expire_on_close SESSION_EXPIRE_ON_CLOSE
session.encrypt SESSION_ENCRYPT
session.cookie SESSION_COOKIE
session.domain SESSION_COOKIE_DOMAIN
session.http_only SESSION_COOKIE_HTTP_ONLY
session.secure SESSION_COOKIE_SECURE
session.same_site SESSION_COOKIE_SAME_SITE

Credits

Some ideas were borrowed from aspendigital/docker-octobercms. Their images work great for October.