Minds Docs

Minds Docs

  • Docs
  • Code
  • Bounties
  • Minds.com

›Getting started

Getting started

  • Introduction
  • Installation
  • Troubleshooting

Guides

  • Architecture
  • Frontend
  • Backend
  • Mobile
  • QA
  • Deployment
  • Documentation
  • Git / GitLab
  • Share to Minds
  • Supported Platforms for Minds

Contributing

  • Contributing
  • License

Walk-throughs

  • Backend modules
  • Backend tests
  • Block
  • Event streams
  • Frontend tests
  • Sending emails
  • Feature flags
  • Feed algorithms
  • Infinite scroll
  • Notifications
  • Postman collection
  • Mobile internationalization
  • Mobile git workflow and CI
  • Mobile styles and themes
  • A/B Testing
  • DID
  • Blockchain

Handbook

  • How we work
  • Bug reporting
  • Security Practices
  • Incident Management

Pro

  • Domains
  • Developers

Infrastructure

  • Kubernetes Autoscaling
Edit

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 [email protected]'

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
Last updated on 10/15/2020
← InstallationArchitecture →
  • Turn it off and on again
  • Nuclear Option
  • Localhost will not load
  • Minds is already installed
  • Cassandra will not boot
  • Docker is frozen
  • ElasticSearch is missing indexes (Linux)
Minds Docs
Docs
Getting startedGuidesContributing
Community
Open Source Community GroupStack Overflow
More
GitLabStar
Copyright © 2022 Minds Inc.