github-personal/firezone
1
0
Fork 0
mirror of https://github.com/outbackdingo/firezone.git synced 2026-01-27 10:18:54 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update troubleshooting guide for clearing auth config in DB (#1338)

Browse Source 
Refs #1313
This commit is contained in:
Jamil
2023-01-19 17:46:37 -08:00
committed by GitHub
parent 48a3621aed
commit 30fe5650ed
1 changed files with 22 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

25
docs/docs/administer/troubleshoot.mdx
View File

@@ -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:
<Tabs>
<TabItem value="docker" label="Docker" default>
```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 = '[]'"
```
</TabItem>
<TabItem value="omnibus" label="Omnibus">
```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 = '[]'"
```
</TabItem>
</Tabs>
## Debugging portal WebSocket connectivity issues
The portal UI requires a secure websocket connection to function. To facilitate