allianceauth

Troubleshooting

Something broken? Stuck on an issue? Can’t get it set up?

Start by checking the issues - especially closed ones.

No answer?

Common Problems

pip install -r requirements.txt is failing

It’s probably a permissions issue. Ensure your current user can write to the virtual environment folder. That, or you’re missing a dependency of some kind which will be indicated in the error message.

I’m getting an error 500 trying to connect to the website on a new install

Great. Error 500 is the generic message given by your web server when anything breaks. The actual error message is hidden in one of your auth project’s log files. Read them to identify it.

Failed to configure log handler

Make sure the log directory is write-able by the allianceserver user: chmown -R allianceserver:allianceserver /path/to/myauth/log/, then restart the auth supervisor processes.

Groups aren’t syncing to services

Make sure the background processes are running: supervisorctl status myauth:. If myauth:worker or myauth:beat do not show RUNNING read their log files to identify why.

Task queue is way too large

Stop celery workers with supervisorctl stop myauth:worker then clear the queue:

redis-cli FLUSHALL
celery -A myauth worker --purge

Press Control+C once.

Now start the worker again with supervisorctl start myauth:worker

Proxy timeout when entering email address

This usually indicates an issue with your email settings. Ensure these are correct and your email server/service is properly configured.