docs: add docs for recovery keys
This commit is contained in:
		
							
								
								
									
										23
									
								
								website/docs/troubleshooting/login.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										23
									
								
								website/docs/troubleshooting/login.md
									
									
									
									
									
										Normal file
									
								
							@ -0,0 +1,23 @@
 | 
			
		||||
---
 | 
			
		||||
title: Troubleshooting Login problems
 | 
			
		||||
---
 | 
			
		||||
 | 
			
		||||
In case you can't login anymore, perhaps due to an incorrectly configured stage or a failed flow import, you can create a recovery key.
 | 
			
		||||
 | 
			
		||||
:::caution
 | 
			
		||||
This recovery key will give whoever has the link direct access to your instances. Keep this key safe.
 | 
			
		||||
:::
 | 
			
		||||
 | 
			
		||||
To create the key, run the following command:
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
docker-compose run --rm server create_recovery_key 10 akadmin
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
or, for Kubernetes, run
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
kubectl exec -it authentik-web-<hash> -- ./manage.py create_recovery_key 10 akadmin
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
This will output a link, that can be used to instantly gain access to authentik as the user specified above. The link is valid for amount of years specified above, in this case, 10 years.
 | 
			
		||||
@ -149,6 +149,7 @@ module.exports = {
 | 
			
		||||
            items: [
 | 
			
		||||
                "troubleshooting/access",
 | 
			
		||||
                "troubleshooting/emails",
 | 
			
		||||
                "troubleshooting/login",
 | 
			
		||||
            ],
 | 
			
		||||
        },
 | 
			
		||||
        {
 | 
			
		||||
 | 
			
		||||
		Reference in New Issue
	
	Block a user