Forum OpenACS Development: OpenACS 5.10.1 via Docker Stack

Dear all,

If you want to quickly look at OpenACS 5.10.1, you might consider running this release containerized via docker using the docker image gustafn/openacs:latest [1].

Steps to use it:

- install a recent version of docker (the installed version should support “docker compose” (two words)
- install portainer (optional)

   portainer=portainer-ce:lts
   docker pull portainer/$portainer
   docker run -d -p 9443:9443 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/$portainer

- The commands above will allow you to connect to the web interface of portainer on your (local)host via HTTPS port 9443.

- in portainer, create a new “stack” named e.g. "oacs-all-inclusive” and paste into it the docker-compose file from [1] and the environment variables from [1] and say “Deploy the stack”.

The first time the startup will take a few moments (20-30 secs). You can check the log-files from the DB and OpenACS from the portainer interface “Quick actions” (see image). During the first installation, OpenACS is installed from the OpenACS source code repository (currently CVS).

- once you see the “listening” entry in the log file of NaviServer, connect to port 8445 (or what ever port you have specified, or via the port under “Published Ports”) and do the usual final configuration steps for OpenACS as described in [1]. The used port is also listed under "Published Ports" on the "Stack details" stack of the "docker stack" you have just created.

The docker images are created for linux/amd64 and linux/arm64 (i.e., works also under macOS on Apple Silicon). Get more details from [1,2], see the related images on [3]. The basic architecture of the images is also covered in the presentation of the last OpenACS conference [4,5].

The description pages of the docker images will be incrementally improved, including setups with Database and/or OpenACS directory on the docker host instead of the container, etc.).

[1] https://hub.docker.com/repository/docker/gustafn/openacs/general
[2] https://hub.docker.com/repository/docker/gustafn/naviserver/general
[3] https://hub.docker.com/repositories/gustafn
[4] https://openacs.org/conf2024/info/download/file/openacs-conf-2024-naviserver5.pdf
[5] https://learn.wu.ac.at/eurotcl2024/lecturecasts/729144776?m=delivery