Installation

Docker Setup

1. Clone repository

git clone 
cd WePledge

2. Load the submodules

git submodule update --init --recursive

3. Run docker

docker compose up

Trouble Shooting

Backend containers fail to build

Before rebuilding all backend docker containers, do the following:

1. Delete all files except for the __init__.py file in the folder ./WePledge/backend/src/emissions/migrations.
2. Delete all backend containers (wepledge_pgadmin_1, wepledge_backend_1 and db)
3. Run docker volume prune to delete the database.
4. Run `docker compose up´.

Module not found in backend container

The backend container won't build correctly, because Module not found django_extensions.

Solution: Delete all containerst and images. Then run docker volume prune to delete all data associated with them.

Send Registration email failed

When registering a new user, sending the activation email fails.

Solution: Add the EMAIL_FROM variable to settings.py (see Django-Graphql_Auth Docs)

GRAPHQL_AUTH = {
    'LOGIN_ALLOWED_FIELDS': ['email', 'username'],
    'SEND_ACTIVATION_EMAIL': True,
    'EMAIL_FROM': 'no-reply@pledge4future.org',
}

Are you trying to mount a directory onto a file

Error response from daemon: OCI runtime create failed: container_linux.go:380: starting container process caused: process_linux.go:545: container init cau
sed: rootfs_linux.go:76: mounting "/run/desktop/mnt/host/c/Users/ninak/Documents/pledge4future/git1/WePledge/.env" to rootfs at "/home/python/app/src/.env
" caused: mount through procfd: not a directory: unknown: Are you trying to mount a directory onto a file (or vice-versa)? Check if the specified host pat
h exists and is the expected type

Solution:

1. Make sure the .env file in ./WePledge exists. If not create it.
2. Delete all folders which were created by docker called .env in ./WePledge and ./WePledge/backend/src.
3. Delete all containers, images and volumes and run docker compose up --build again.

Error: standard_init_linux.go:219: exec user process caused: no such file or directory

Solution:

1. Open ./backend/src/entrypoint.sh and ./frontend/entrypoint.sh in notepad++
2. Go to edit -> EOL conversion -> change both from CRLF to LF.
3. Save the files.

Rebuild the images and containers after the backend code has changed

Do the following to build the docker images, containers and volume from scratch to avoid errors:

1. Delete all files except for the init.py in the folder ./WePledge/backend/src/emissions/migrations.
2. Delete all backend containers (wepledge_pgadmin_1, wepledge_backend_1 and db)
3. Run docker volume prune to delete the volumes associated witch the deleted containers.
4. Run docker compose up --build to rebuild the images.