Troubleshooting
Turn it off and on again
If you're not sure why things aren't working, try these first:
Is everything running?
minds up
Needs a kick?
minds restart
When in doubt, re-run the local stack installation.
minds install
Nuclear Option
When things aren't running smoothly in your Dockerized environment and the steps above haven't fixed the problem, sometimes it's best to start from scratch. Follow these steps to completely delete your data and start fresh:
# Remove your settings file
rm engine/settings.php
# Stop your stack
docker-compose down
# Delete your data cache
rm -rf .data
# Purge all volumes
docker volume prune
After you've deleted your data, you can either rebuild the containers manually by using docker-compose up --build
or delete them:
# Delete all containers
docker rm $(docker ps -a -q)
Localhost will not load
If localhost fails to load, but localhost/login works fine, then you may need to create the index.php manually. This can be done by entering the project root, starting everything up, and running:
docker-compose exec php-fpm sh
cd /var/www/Minds/front/dist
touch index.php
Minds is already installed
- Ensure engine/settings.php does not exist and re-run
docker-compose up installer
Cassandra will not boot
- Ensure thrift is enabled
- Cassandra requires at least 4GB of memory to operate. You can start Cassandra manually by running
docker-compose up cassandra
Docker is frozen
- You might need to increase the resources allotted to Docker. To do this, go to Docker > Preferences > Advanced. From there, move the CPU/Memory sliders up and see if that fixes the problem
ElasticSearch is missing indexes (Linux)
Sometimes on Linux there can be still be problems after building the Elasticsearch indexes, due to permission issues. This can manifest in a few ways, but is usually indicated simply by an error complaining about missing indexes in ElasticSearch.
First, run this command, or add it to your .bashrc or .zshrc to have it permanently available:
alias dm-disk='docker run --rm -it -v /:/docker alpine:edge $@'
Next, run docker volume ls
and find the name of the Elasticsearch data container.
Copy it to your clipboard, and run the second command, replacing the end with the copied name:
docker volume ls
docker volume inspect xxxxx_elasticsearch_etc
This will output JSON to your terminal. In that JSON, look for the Mountpoint key, and copy over the path value (we will call it $MOUNTPOINT).
It should look something like this: /var/lib/docker/volumes/minds_elasticsearch-data/_data
Next up, you need to run:
dm-disk
chmod -R 0777 /docker/$MOUNTPOINT