diff --git a/docs/docs/administer/troubleshoot.mdx b/docs/docs/administer/troubleshoot.mdx index 575a4b937..3f895e850 100644 --- a/docs/docs/administer/troubleshoot.mdx +++ b/docs/docs/administer/troubleshoot.mdx @@ -28,20 +28,39 @@ Firezone logs are stored in `/var/log/firezone` and can be viewed with ## Application crash loop preventing config changes In cases where the application is crash looping because of corrupt, inaccessible, or -invalid data in the DB, you can try clearing the affected fields. +invalid OIDC or SAML configuration in the DB, you can try clearing the affected fields. For example, to clear OIDC configs: + + + ```text -psql -d firezone -h 127.0.0.1 -U postgres -c "UPDATE configurations SET openid_connect_providers = '{}'" +psql -d firezone -h 127.0.0.1 -U postgres -c "UPDATE configurations SET openid_connect_providers = '[]'" ``` Similarly, to clear SAML configs: ```text -psql -d firezone -h 127.0.0.1 -U postgres -c "UPDATE configurations SET saml_providers = '{}'" +psql -d firezone -h 127.0.0.1 -U postgres -c "UPDATE configurations SET saml_identity_providers = '[]'" ``` + + + +```text +/opt/firezone/embedded/bin/psql -d $DATABASE_NAME -h $DATABASE_HOST -U $DATABASE_USER -c "UPDATE configurations SET openid_connect_providers = '[]'" +``` + +Similarly, to clear SAML configs: + +```text +/opt/firezone/embedded/bin/psql -d $DATABASE_NAME -h $DATABASE_HOST -U $DATABASE_USER -c "UPDATE configurations SET saml_identity_providers = '[]'" +``` + + + + ## Debugging portal WebSocket connectivity issues The portal UI requires a secure websocket connection to function. To facilitate