Habitat

Appearance

Troubleshooting ​

Lost Administrator Password ​

As with any user password, the administrator password can be recovered by clicking the Forgot password link on the login page. This method requires a working mail configuration. In the event that you are not able to recover the administrator password using this method, you can run the following command on the host machine to force the reset of the administrator password:

shellscript
docker exec -it habitat sh -c 'php bin/console habitat:reset-admin-password'

Reverse Proxy SSL Certificate Issues ​

Those using a reverse proxy such as Nginx Proxy Manager or Traefik might find themselves in a catch-22 when first launching Habitat. It attempts to attain an SSL certificate, but LetsEncrypt can't load the application to verify because it doesn't have a correctly configured SSL certificate.

This can be resolved by temporarily setting the SERVER_NAME variable to http://${DOMAIN}:80 in docker-compose.yml. Once a certificate has been attained, it should be fine to change the variable back to https://${DOMAIN} to secure your traffic.

Other Issues ​

Check the Habitat issues board on GitHub, and if you can't find your issue listed, feel free to create it.