Skip to content

Latest commit

 

History

History
352 lines (283 loc) · 14.1 KB

README-Docker.md

File metadata and controls

352 lines (283 loc) · 14.1 KB
Raw

Admidio

Admidio is a free open source user management system for websites of organizations and groups. The system has a flexible role model so that it’s possible to reflect the structure and permissions of your organization. You can create an individual profile for your members by adding or removing fields. Additional to these functions the system contains several modules like member lists, event manager, guestbook, photo album or a documents & files area.

logo

Supported tags and respective Dockerfile links

GitHub release (latest by date) GitHub tag (latest by date)

Docker Cloud Automated build Docker Cloud Build Status Docker Image Size (tag) MicroBadger Layers (tag) Docker Pulls

You can find the releasenotes on Github admidio/releases and the Docker images on Dockerhub admidio/admidio.

How to use this image

Start a mariadb server instance (optional)

Starting a mariadb instance. The admidio database and admidio user will be created automatically.

docker run --detach -it --name "Admidio-MariaDB" \
  -p 3306:3306 \
  --restart="unless-stopped" \
  -v "Admidio-MariaDB-confd:/etc/mysql/conf.d" \
  -v "Admidio-MariaDB-data:/var/lib/mysql" \
  -e MYSQL_DATABASE="admidio" \
  -e MYSQL_ROOT_PASSWORD="my_VerySecureRootPassword.01" \
  -e MYSQL_USER="admidio" \
  -e MYSQL_PASSWORD="my_VerySecureAdmidioUserPassword.01" \
  mariadb:10.5.8

Start an admidio server instance

Starting a admidio instance is simple:

docker run --detach -it --name "Admidio" \
  -p 8080:8080 \
  --restart="unless-stopped" \
  -v "Admidio-files:/opt/app-root/src/adm_my_files" \
  -v "Admidio-themes:/opt/app-root/src/adm_themes" \
  -v "Admidio-plugins:/opt/app-root/src/adm_plugins" \
  --link "Admidio-MariaDB:mysql" \
  admidio/admidio:latest

... where Admidio is the name you want to assign to your container.

Start an admidio server instance with advanced options

docker run --detach -it --name "Admidio" \
  --memory="1024m" \
  -p 8080:8080 \
  --restart="unless-stopped" \
  -v "Admidio-files:/opt/app-root/src/adm_my_files" \
  -v "Admidio-themes:/opt/app-root/src/adm_themes" \
  -v "Admidio-plugins:/opt/app-root/src/adm_plugins" \
  --link "Admidio-MariaDB:mysql" \
  -e ADMIDIO_DB_TYPE="mysql" \
  -e ADMIDIO_DB_HOST="db:3306" \
  -e ADMIDIO_DB_NAME="admidio" \
  -e ADMIDIO_DB_TABLE_PRAEFIX="adm" \
  -e ADMIDIO_DB_USER="admidio" \
  -e ADMIDIO_DB_PASSWORD="my_VerySecureAdmidioUserPassword.01" \
  -e ADMIDIO_MAIL_RELAYHOST="hostname.domain.at:25" \
  -e ADMIDIO_LOGIN_FOR_UPDATE="1" \
  -e ADMIDIO_ORGANISATION="ADMIDIO" \
  -e ADMIDIO_PASSWORD_HASH_ALGORITHM="DEFAULT" \
  -e ADMIDIO_ROOT_PATH="https://www.mydomain.at/admidio" \
  -e TZ="Europe/Vienna" \
  -e HTTPD_START_SERVERS="8" \
  -e DOCUMENTROOT="/" \
  -e PHP_MEMORY_LIMIT="256M" \
  -e ERROR_REPORTING="E_ALL & ~E_NOTICE" \
  -e DISPLAY_ERRORS="ON" \
  -e DISPLAY_STARTUP_ERRORS="OFF" \
  -e TRACK_ERRORS="OFF" \
  -e HTML_ERRORS="ON" \
  admidio/admidio:latest

General docker options

  • --restart="unless-stopped": Always start container, except when it was stopped.
  • --name "Admidio": Docker container name
  • --memory="1024m": limit ram usage of docker container to 1GB
  • -p 8080:8080: published port (see https://docs.docker.com/config/containers/container-networking/#published-ports)
  • admidio/admidio:latest: Image name with version tag. We recommend a special version tag to be used instead of latest (e.g.: admidio/admidio:v4.0.4)

Database container link

  • --link "Admidio-MariaDB:db": connect to docker database server instance.
    Admidio-MariaDB = name of the mariadb docker container
    db = internal hostname of the database server

See https://docs.docker.com/network/links/.
Use MariaDB or PostgreSQL images to start database container.

Volumes

  • -v "Admidio-files:/opt/app-root/src/adm_my_files": admidio config files and data uploads
  • -v "Admidio-themes:/opt/app-root/src/adm_themes": admidio themes
  • -v "Admidio-plugins:/opt/app-root/src/adm_plugins": admidio plugins

See https://docs.docker.com/storage/volumes/ for detailed information.

Environment Variables

When you start the admidio image, you can adjust the configuration of the Admidio instance by passing one or more environment variables on the docker run command line.

ADMIDIO_DB_TYPE

Admidio supports in addition to MySQL also PostgreSQL databases. This variable specifies which database engine is to be used.

Possible values: mysql or postgresql

see https://www.admidio.org/dokuwiki/doku.php?id=en:2.0:konfigurationsdatei_config.php#gdbtype

ADMIDIO_DB_HOST

A combination of hostname and port of database server. e.g.: localhost:3306

Database Host: The name of the database server. This is specified by the hoster. For a local device it could be localhost or 127.0.0.1.

Possible values: default by Host

see https://www.admidio.org/dokuwiki/doku.php?id=en:2.0:konfigurationsdatei_config.php#g_adm_srv

Database Port: Optionally the port to the database can be specified here. If this parameter is not set, the default port of the database (MySQL: 3306, PostgreSQL: 5432) is used. Possible values: Specification from the webhoster

see https://www.admidio.org/dokuwiki/doku.php?id=en:2.0:konfigurationsdatei_config.php#g_adm_port

ADMIDIO_DB_NAME

Name of the database in which the tables Admidio been created. This is specified by the hoster.

see https://www.admidio.org/dokuwiki/doku.php?id=en:2.0:konfigurationsdatei_config.php#g_adm_db

ADMIDIO_DB_TABLE_PRAEFIX

All tables of Admidio in the database get a unified prefix, which is defined here. If you want to set up another Admidio installation in the same database, so each Admidio installation must have its own prefix. About the indication stored here knows Admidio belong which tables to this installation with this configuration file.

Possible values: adm or any combination

see https://www.admidio.org/dokuwiki/doku.php?id=en:2.0:konfigurationsdatei_config.php#g_tbl_praefix

ADMIDIO_DB_USER

Name of the user who can log onto the database. This is specified by the hoster.

see https://www.admidio.org/dokuwiki/doku.php?id=en:2.0:konfigurationsdatei_config.php#g_adm_usr

ADMIDIO_DB_PASSWORD

Password of the user who can log on to the database. This is specified by the hoster.

see https://www.admidio.org/dokuwiki/doku.php?id=en:2.0:konfigurationsdatei_config.php#g_adm_pw

ADMIDIO_MAIL_RELAYHOST

Postfix relayhost parameter to support mail delivery. Possible value: hostname.domain.at:port (e.g.: hostname.domain.at:25)

ADMIDIO_LOGIN_FOR_UPDATE

This flag ensures that a database update can only be carried out on a new Admidio version, if an administrator has given his credentials in the update script. This function is always active in the default and can be disabled in the config.php via this parameter. For security reasons, we recommend that this feature should always be enabled. In a test systems it is useful to disable the function.

Possible values: 0 (disabled) or 1 (enabled)

see https://www.admidio.org/dokuwiki/doku.php?id=en:2.0:konfigurationsdatei_config.php#gloginforupdate

ADMIDIO_ORGANISATION

The abbreviation of the default organization. Are managed through Admidio multiple organizations, each organization could have their own Web space and this variable controls which organization is managed through this Webspace. If several organizations over a Webspace controlled, so this variable indicates the organization, which is pre-selected at login.

Possible values: Value from table field adm_organizations::org shortname

see https://www.admidio.org/dokuwiki/doku.php?id=en:2.0:konfigurationsdatei_config.php#g_organization

ADMIDIO_PASSWORD_HASH_ALGORITHM

Optionally, the encryption algorithm for the user passwords can be stored here. This should always point to DEFAULT . Then the best algorithm, supported by all current PHP installations, is taken. SHA512 is not automatically available on all servers, so this option should only be selected if it is ensured that the Admidio version will always run on a server that supports this encryption. The encodings ARGON2ID and ARGON2I are only available from Admidio 4.

Possible values: ​DEFAULT,​ ​BCRYPT,​ ​SHA512, ARGON2ID, ARGON2I​

see https://www.admidio.org/dokuwiki/doku.php?id=en:2.0:konfigurationsdatei_config.php#gpasswordhashalgorithm

ADMIDIO_ROOT_PATH

"https://www.mydomain.at/admidio" \

TZ

Specifying the time zone that will be used for this organization. The value corresponds to one of PHP support Time Zone. The time zone is set once during installation and should not thereafter be changed. Must the time zone be nevertheless adjusted later, so the times already recorded are not adjusted to the new time zone.

Possible values: Europe/Berlin

see https://www.admidio.org/dokuwiki/doku.php?id=en:2.0:konfigurationsdatei_config.php#gtimezone

HTTPD_START_SERVERS / PHP_MEMORY_LIMIT / ...

Some environment variables come from ubi8 base image. See Environment variables for Source-to-Image on https://catalog.redhat.com/software/containers/ubi8/php-74/5f521244e05bbcd88f128b63 for detailed information.

Admidio update

run following steps to update to a newer admidio version.

  • get latest version from dockerhub
docker pull admidio/admidio:latest
  • stop current running container
docker stop Admidio
  • delete existing container
docker rm Admidio
  • use the same start command as last
docker run --detach -it --name "Admidio" \
    -p 8080:8080 \
    --restart="unless-stopped" \
    -v "Admidio-files:/opt/app-root/src/adm_my_files" \
    -v "Admidio-themes:/opt/app-root/src/adm_themes" \
    -v "Admidio-plugins:/opt/app-root/src/adm_plugins" \
    --link "Admidio-MariaDB:mysql" \
    admidio/admidio:latest
  • look at admidio update page and follow the instructions for the specified version Admidio Wiki Update.

Docker Compose usage

Docker Compose Example (docker-compose.yaml)

version: '3.9'

services:
  db:
    restart: always
    image: mariadb:10.5.8
    contaner_name: Admidio-MariaDB
    volumes:
      - "Admidio-MariaDB-confd:/etc/mysql/conf.d"
      - "Admidio-MariaDB-data:/var/lib/mysql"
    ports:
      - 3306:3306
    environment:
      - MYSQL_ROOT_PASSWORD=secret-password
      - MYSQL_DATABASE=admidio
      - MYSQL_USER=admidio
      - MYSQL_PASSWORD=secret-password

  admidio:
    restart: always
    image: admidio/admidio:v4.0.4
    contaner_name: Admidio
    depends_on:
      - db
    volumes:
      - Admidio-files:/opt/app-root/src/adm_my_files
      - Admidio-themes:/opt/app-root/src/adm_themes
      - Admidio-plugins:/opt/app-root/src/adm_plugins
    ports:
      - 8080:8080
    environment:
      ADMIDIO_DB_TYPE: "mysql"
      ADMIDIO_DB_HOST: "db:3306"
      ADMIDIO_DB_NAME: "admidio"
      ADMIDIO_DB_USER: "admidio"
      ADMIDIO_DB_PASSWORD: "secret-password"
      # ADMIDIO_DB_TABLE_PRAEFIX: "adm"
      # ADMIDIO_MAIL_RELAYHOST: "hostname.domain.at:25"
      # ADMIDIO_LOGIN_FOR_UPDATE: "1"
      # ADMIDIO_ORGANISATION: "ADMIDIO"
      # ADMIDIO_PASSWORD_HASH_ALGORITHM: "DEFAULT"
      # ADMIDIO_ROOT_PATH: "https://www.mydomain.at/admidio"
      # TZ: "Europe/Vienna"
      # HTTPD_START_SERVERS: "8"
      # DOCUMENTROOT: "/"
      # PHP_MEMORY_LIMIT: "256M"
      # ERROR_REPORTING: "E_ALL & ~E_NOTICE"
      # DISPLAY_ERRORS: "ON"
      # DISPLAY_STARTUP_ERRORS: "OFF"
      # TRACK_ERRORS: "OFF"
      # HTML_ERRORS: "ON"

Docker Compose Example with local build (docker-compose.yaml)

We also deliver a Dockerfile and you can easily build and use your own docker image.

version: '3.9'

services:
  db:
    restart: always
    image: mariadb:10.5.8
    contaner_name: Admidio-MariaDB
    volumes:
      - "Admidio-MariaDB-confd:/etc/mysql/conf.d"
      - "Admidio-MariaDB-data:/var/lib/mysql"
    ports:
      - 3306:3306
    environment:
      - MYSQL_ROOT_PASSWORD=secret-password
      - MYSQL_DATABASE=admidio
      - MYSQL_USER=admidio
      - MYSQL_PASSWORD=secret-password

  admidio:
    build: .
    image: yourUsername/admidio:v4.0.4
    contaner_name: Admidio
    restart: always
    depends_on:
      - db
    volumes:
      - Admidio-files:/opt/app-root/src/adm_my_files
      - Admidio-themes:/opt/app-root/src/adm_themes
      - Admidio-plugins:/opt/app-root/src/adm_plugins
    ports:
      - 8080:8080
    environment:
      ADMIDIO_DB_TYPE: "mysql"
      ADMIDIO_DB_HOST: "db:3306"
      ADMIDIO_DB_NAME: "admidio"
      ADMIDIO_DB_USER: "admidio"
      ADMIDIO_DB_PASSWORD: "secret-password"
      # ADMIDIO_DB_TABLE_PRAEFIX: "adm"
      # ADMIDIO_MAIL_RELAYHOST: "hostname.domain.at:25"
      # ADMIDIO_LOGIN_FOR_UPDATE: "1"
      # ADMIDIO_ORGANISATION: "ADMIDIO"
      # ADMIDIO_PASSWORD_HASH_ALGORITHM: "DEFAULT"
      # ADMIDIO_ROOT_PATH: "https://www.mydomain.at/admidio"
      # TZ: "Europe/Vienna"
      # HTTPD_START_SERVERS: "8"
      # DOCUMENTROOT: "/"
      # PHP_MEMORY_LIMIT: "256M"
      # ERROR_REPORTING: "E_ALL & ~E_NOTICE"
      # DISPLAY_ERRORS: "ON"
      # DISPLAY_STARTUP_ERRORS: "OFF"
      # TRACK_ERRORS: "OFF"
      # HTML_ERRORS: "ON"