ProjectSend Docker

This repo contains configuration to add a Docker functionality to ProjectSend in a more service oriented architecture; five apps have been contenerized to enable faster development. Use this configuration on a prod env at your own risk.

Services

Service	Stack	Port	Description	Default
mysql	mysql 8.4.2	3306		Yes
phpmyadmin	phpmyadmin	8080	phpmyadmin	No
main	ProjectSend	80	ProjectSend Service running on PHP-fpm	Yes
mailer	MailHog	1025/8025	MailHog as a dummy SMTP server	No
router	NGINX	80 / 443	proxy service for local dev	Yes

Routing

Domain	Services	Main Routes
main.app.local	ProjectSend	/
phpmyadmin.app.local	PhpMyAdmin	/
mailer.app.local	MailHog Service	/ /api/*

Setup

• Prerequisites:

  • Have docker installed (v20)
  • Have docker-compose installed (v1.29)

• Add the following records to your comuters /etc/hosts file on local(not in docker)

  127.0.0.1       main.app.local
  127.0.0.1       mailer.app.local
  127.0.0.1       phpmyadmin.app.local
  

• Copy the contents of .env.example into .env

  • All services have been defined in the example file and have been set to disabled.
    • enabled this run the app on the machine
    • disabled This will run a dummy place holder instead of the actual service. NOTE: Please make sure your account is able to pull the images from the ECR

Execution

• First step is to modify your local .env
• run docker-compose build to build all configured services, this could take up to 10m.
• run docker-compose start or docker-compose up -dto start docker in daemon mode.
• on your browser go to http://main.app.local

Notes

• Try to avoid leaving unecessary services running.
• Minimum Ammount of Ram allocated for Docker should be 4GB.
• The initial startup of MySql takes some time (about 5m) depending on the hardware resources allocated to Docker.
• You will be able to use the app once the DB container starts up. The container logs will have the following message: mysqld: ready for connections.
• both HTTP and HTTPS work locally. Since the certificate is self-signed you will need to trust the signer before you can open HTTPS.