HUB
Sign inSign up

unillett/yakforms

Sponsored OSS

By UNIL

•Updated 6 days ago

Docker image for the Yakforms application

Image
Content management system
Web analytics
0

10.0K

unillett/yakforms repository overview

⁠Information

Docker configuration for the Yakforms⁠ project. This is a Drupal 7 / PHP 7.4 application that lets you create simple forms, then collect and analyze the responses.

It is not actively maintained anymore, we'll keep the stack frozen until a better solution is found.

⁠Development with Docker

⁠Docker installation

A working Docker⁠ installation is mandatory.

⁠Environment files

Make sure to copy & rename the following environment files.

cp env.example .env
cp db.env.example db.env

You can replace the values if needed to match you server & environment.

Make sure to copy & rename the docker-compose.override.yml.dev file to docker-compose.override.yml.

cp docker-compose.override.yml.dev docker-compose.override.yml

You can replace the values if needed, but the default ones should work for local development.

⁠Build & run

Build & run all the containers for this project.

docker compose up (add -d if you want to run in the background and silence the logs)

⁠Frontends

To access the main application please use the following link.

http://localhost:8787⁠

The first time you access the application, you will be redirected to the installation page (see below for the installation instructions).

⁠Deployment with Docker

⁠Environment files

Make sure to copy & rename the following environment files.

cp env.example .env
cp db.env.example db.env

You should replace the values since the default ones are not ready for production.

Copy & rename the docker-compose.override.yml.prod file to docker-compose.override.yml.

cp docker-compose.override.yml.prod docker-compose.override.yml

You can replace the values if needed, but the default ones should work for production.

⁠Installation & configuration

Build & run all the containers for this project.

docker compose up -d

⁠Reverse proxy

Use a reverse proxy configuration to map the url to port 8787.

⁠Installation instructions

When you first access the application, you will be redirected to the installation page.

⁠1. Database configuration

  • Choose PostgreSQL as the database type
  • Add connection parameters (report values from the .env file, below are the default development values)
    • Database name: yakforms
    • Username: user
    • Password: password
    • Host: yakforms-postgres
    • Port: 5432

⁠2. Then, configure the admin account

⁠3. Add French & make it the default language

Use the following path: /admin/config/regional/language

⁠4. Activate Yakforms modules

Use the following path: /admin/modules

  • "yakforms-feature"
  • "Yakforms"
  • "Yakforms Public Results" & "Yakforms Share Results"

⁠5. Activate the Yakforms "Lettres" theme, make it the default & use it also for admin

Use the following path: /admin/appearance

⁠6. Update general information & create default pages

Use the following path: /admin/config/system/yakforms

⁠8. Activate & configure modules

Use the following path: /admin/modules

  • "SMTP Authentication Support"
  • If needed also "Active Directory Integration / LDAP Integration - NTLM & Kerberos Login"

⁠Update instructions

Everything in /themes, /modules, /libraries & /files is managed by composer and will be updated on the next docker compose up.

Files in the /fix & /views folders are backed into the docker image, they will either be updated on the next docker compose build / docker compose pull, or stored in the database during the first setup and persist in the application database volume (should be updated manually).

⁠Docker images

The Dockerfile extracts the application files from a pre-packaged Docker image, and runs them on a CVE-patched PHP 7.4 base image. This is needed since the project is not maintained anymore and the stack is frozen.

GitHub Actions workflows generate Docker image tags based on these events:

  • Push to development: dev-latest, stage-latest
  • Push to master: latest
  • Push a git tag: vX.Y.Z (immutable)

Tag summary

Content type

Image

Digest

sha256:ad6c62af7…

Size

198.9 MB

Last updated

6 days ago

docker pull unillett/yakforms

This week's pulls

Pulls:

190

Last week