Skip to content

Common Issues for New Developers

Corey Peterson edited this page Aug 25, 2023 · 2 revisions

If you're working on setting up Materia to contribute for the first time, there are a number of common gotchas and issues that may get in the way:

Issues with Docker Compose

As of Fall 2023, Materia remains incompatible with docker-compose v2. Your Docker Desktop application is configured to use compose v2 by default. This can be unchecked by going to settings -> general -> Use Docker Compose v2

Static assets not loading

If you notice that JS and CSS assets aren't loading on 127.0.0.1, remember that in addition to serving pages over 127.0.0.1:443 (the standard https port), static assets are served over 127.0.0.1:8008. You may need to create certificate exceptions for this domain:port in your browser.

Restarting from scratch

These commands represent the nuclear option to destroy your containers and images locally. Note that this will destroy ALL containers and images on your local filesystem. Make sure you don't have any other projects or applications that rely on docker!!!

$ docker kill $(docker ps -a -q)
$ docker rm $(docker ps -a -q)
$ docker rmi $(docker images -a)