This is a Docker Compose file which starts up a standalone Freegle system, typically for development.

Pre-requisites

You'll need Docker and a clone of this repo.

Building

Then start the system::

docker-compose up --build

This takes a few minutes to settle down. It pulls up to date code from git each time you start the containers.

Using

Then you can access:

• Freegle, the user site. Log in as [email protected] / freegle, or register.
• ModTools, the moderator site. Log in as [email protected] / freegle
• PhpMyAdmin, to view or tweak the database.
• Mailhog (to view emails sent by the system; TODO none actually sent yet)

Note that these are all http links; no SSL. This means that at the moment images won't work in local testing because they are served over https.

Configuration

The system contains one test group, FreeglePlayground, centered around Edinburgh.
The only recognised postcode is EH3 6SS.

Using a real domain

Although this setup is hardcoded to use the hostnames above, you can use it on a real domain with appropriate nginx configuration. See nginx.conf for the config.

Rebuilding

If you need to wipe it and build from scratch:

docker system prune -a