Docker Composer Installation on UNIX

[K-vanc]

Dear Tempest Users;

Since this is one of the most confusing subject for UNIX OS docker users who want to use composer for installation, I want to hardcode here the proper way of installation steps. First of all, Tempest docker image is set to user "nobody" and group "nogroup" by default to eliminate possible permission issues. Many composer users are just copy/pasting parameters from a working template without knowing the meaning of options such as "PUID" , "PGID" etc. Basicly, these parameters are for setting user/group permissions of files and since nobody/nogroup has the lowest privileges, anyt other user set by PUID/PGID will cause a permission issue and Tempest folder structure will not be generated. So simply, we are not using any of them.

Another thing on UNIX distros is, your local folder(s) to be mounted shall have the same user/group ownership with container so prior to using composer install, we need to change our local mount folder ownerships to nobody:nogroup via chown command.

sudo mkdir /your/local/mount/folder/tempest/
sudo chown nobody:nogroup -R /your/local/mount/folder/tempest/
sudo chmod 755 -R /your/local/mount/folder/tempest/

Now, our local folder permission is set so we can prepare composer file as EXAMPLE below;

version: "3.9"
services:
  tempest:
    container_name: "tempest"
    environment:
      - "TZ=Europe/Rome"
    image: "kvanc/tempest_epg"
    restart: "unless-stopped"
    volumes:
      - "/your/local/mount/folder/tempest/:/var/www/html/tempest_config/"
      - "/your/local/mount/folder/tempest/php-user.ini:/etc/php82/conf.d/custom.ini"

As you seen, we used only needed parameters as minimum.