Skip to content

Common Issues for New Developers

Corey Peterson edited this page Oct 11, 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

Materia version 10 was not written with specific support for Compose v2, but should be compatible with it. If you encounter failures related to compose, it may be worthwhile to try using an earlier version of Docker Desktop that provides the option to disable 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)