🐳 Docker image for Dodock applications.
This image was inspired by Monogramm's Frappe container and Dokos docker container:
The concept is the following:
- no need to provide any configuration file: everything will be automatically generated by the container through environnment variables
- the application container sets all the environment variables, the other containers wait for setup to be done
- provide postgresql compatibility
- the container detects and execute migration automatically
- the container detects missing modules / apps and remove them automatically
- allow before and after 'node' custom scripts
Check image Monogramm/docker-dokos to see how to expand this image and build dodock apps.
Full-stack web application framework that uses Python and MariaDB on the server side and a tightly integrated client side library. Built for Dokos.
https://hub.docker.com/r/monogramm/docker-dodock/
- develop-alpine3.12 develop-alpine3.12 alpine3.12 (
images/develop/alpine3.12/Dockerfile
) - develop-slim-buster develop-slim-buster slim-buster develop develop latest (
images/develop/slim-buster/Dockerfile
)
The image supports auto configuration via environment variables.
# The docker "node" type. Defines the behavior of the container.
# This can either be set through command argument or environment variable.
# Can be one of the following:
# doctor
# setup
# setup-database
# build-apps
# update
# backup
# restore
# migrate
# app
# scheduler
# worker
# worker-long
# worker-short
# node-socketio
WORKER_TYPE=
# Time in seconds container will wait for DB to be up
DOCKER_DB_TIMEOUT=120
# MariaDb hosts allowed to log to the DB.
# Only needed with mariadb when database created by dodock (dodock restricts to install IP by default).
# In this case, use 172.%.%.% to allow any container on docker network
DOCKER_DB_ALLOWED_HOSTS=
# Time in seconds container will wait for apps to be setup
DOCKER_APPS_TIMEOUT=600
# Time in seconds container will wait for sites to be setup
DOCKER_SITES_TIMEOUT=900
# Set to 1 to enable display of all log files if container crashes
DOCKER_DEBUG=
DOCKER_GUNICORN_BIND_ADDRESS=0.0.0.0
DOCKER_GUNICORN_PORT=8000
DOCKER_GUNICORN_WORKERS=4
DOCKER_GUNICORN_TIMEOUT=120
DOCKER_GUNICORN_LOGLEVEL=info
# If you want to enable SSL for Dokos App
# If using Let's Encrypt, you should set properties like this:
# certfile=/etc/letsencrypt/live/my.domain.com/fullchain.pem
# keyfile=/etc/letsencrypt/live/my.domain.com/privkey.pem
DOCKER_GUNICORN_CERTFILE=
DOCKER_GUNICORN_KEYFILE=
# List of dodock apps (space separated) to init on startup (bench install-app)
DODOCK_APP_INIT=
# Reset apps.txt
# If set to 1, apps.txt older content will be removed on startup and only contain the content of DODOCK_APP_INIT
DODOCK_APP_RESET=
# Protected apps that shall never be removed automatically
# Mostly used to secure that dodock and dokos are not removed due to misconfiguration
DODOCK_APP_PROTECTED=dodock
# Default protocol. Should either be http (default value) or https when using SSL.
DODOCK_DEFAULT_PROTOCOL=http
# Default site
DODOCK_DEFAULT_SITE=
# Default HTTP port. Should either be 80 (default value) or 443 when using SSL or any custom port defined for the NGinx reverse proxy.
DODOCK_HTTP_PORT=80
# Default backend port. Should either be 80 (default value) or any custom port defined for the app backend.
DODOCK_WEBSERVER_PORT=80
# Default socketion port. Should either be 3000 (default value) or 80 (usual value for prod) or any custom port defined for the socketio service.
DODOCK_SOCKETIO_PORT=3000
# Remove all sites data on startup if set to 1
# This should only be used for dev / test environments
DODOCK_RESET_SITES=
# Reinstall database
# If set to 1, database will be resinstalled. This should only be used for dev / test environments
DODOCK_REINSTALL_DATABASE=
# Build options passed to the bench build command
# Can be used with --restore to copy the public assets instead of symlinking them
DODOCK_BUILD_OPTIONS=
DODOCK_LOGGING=1
GOOGLE_ANALYTICS_ID=
DEVELOPER_MODE=0
ALLOW_TESTS=0
SERVER_SCRIPT_ENABLED=0
ADMIN_PASSWORD=dodock
# Encryption key
# Leave empty to generate a random base64 32 key
ENCRYPTION_KEY=
# DB type. Can either be mariadb or postgresql
DB_TYPE=mariadb
DB_HOST=db
DB_PORT=3306
# DB name. Is also used by dodock for the user name associated
DB_NAME=dodock
DB_PASSWORD=youshouldoverwritethis
# DB root login. Only used for postgresql
DB_ROOT_LOGIN=root
# DB root password. Mandatory
DB_ROOT_PASSWORD=mariadb_root_password
MAIL_MUTED=false
MAIL_HOST=mail
MAIL_PORT=587
MAIL_USE_SSL=tls
MAIL_LOGIN=dodock-mail
MAIL_PASSWORD=youshouldoverwritethis
REDIS_CACHE_HOST=redis_cache
REDIS_QUEUE_HOST=redis_queue
REDIS_SOCKETIO_HOST=redis_socketio
This image does not contain the database for Dodock. You need to use either an existing database or a database container.
This image is designed to be used in a micro-service environment using docker-compose. There are basically 2 variants of the image you can choose from: alpine
or debian
.
- Select the version closest to what you want in the images folder
- You can comment the
build
lines, uncomment theimage
lines and edit versions to download prebuilt docker container.
- You can comment the
- Feel free to edit variables defined in
.env
as you see fit. - Run the docker-compose with
docker-compose up -d
and that's it. - Now, go to http://localhost:80 to access the first run installation wizard.
If you got any questions or problems using the image, please visit our Github Repository and write an issue.