Troubleshooting#

We are doing the best we can so you do not have to read this section.

That said, we have included solutions (or at least explanations) for some common problems below.

If you do not find a solution to your problem here, please ask for help!

socket.error: [Errno 48] Address already in use#

Another process has occupied Django’s default port 8000.

To fix this, see which service is running on port 8000:

$ sudo lsof -i :8000

and kill the process using PID from output:

$ kill -kill [PID]

This means that the navigator.credentials Javascript API refused to start because you are not in a secure context.

This means that either:

You are not connected on your website through HTTPS
The certificate doesn’t match the HOST.
In development, maybe you are trying http://127.0.0.1:8000/kagi/login/ rather than http://localhost:8000/kagi/login/