cgiacofei/TandoorRecipes
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

phrase FAQ as questions

Browse Source
This commit is contained in:
tomtjes 2022-01-15 13:57:20 -05:00
parent 79c8d26e8c
commit 281535e756
1 changed files with 15 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
docs/faq.md
View File

@ -2,7 +2,7 @@ There are several questions and issues that come up from time to time. Here are
Please note that the existence of some questions is due the application not being perfect in some parts. Please note that the existence of some questions is due the application not being perfect in some parts.
Many of those shortcomings are planned to be fixed in future release but simply could not be addressed yet due to time limits. Many of those shortcomings are planned to be fixed in future release but simply could not be addressed yet due to time limits.
## CSRF Errors ## Why am I getting CSRF Errors?
If you are getting CSRF Errors this is most likely due to a reverse proxy not passing the correct headers. If you are getting CSRF Errors this is most likely due to a reverse proxy not passing the correct headers.
If you are using swag by linuxserver you might need `proxy_set_header X-Forwarded-Proto $scheme;` in your nginx config. If you are using swag by linuxserver you might need `proxy_set_header X-Forwarded-Proto $scheme;` in your nginx config.
@ -10,15 +10,15 @@ If you are using a plain ngix you might need `proxy_set_header Host $http_host;`
Further discussions can be found in this [Issue #518](https://github.com/vabene1111/recipes/issues/518) Further discussions can be found in this [Issue #518](https://github.com/vabene1111/recipes/issues/518)
## Images not loading ## Why are images not loading?
If images are not loading this might be related to the same issue as the CSRF Errors. If images are not loading this might be related to the same issue as the CSRF errors (see above).
A discussion about that can be found [Issue #452](https://github.com/vabene1111/recipes/issues/452) A discussion about that can be found at [Issue #452](https://github.com/vabene1111/recipes/issues/452)
The other common issue is that the recommended nginx container is removed from the deployment stack. The other common issue is that the recommended nginx container is removed from the deployment stack.
If removed, the nginx webserver needs to be replaced by something else that servers the /mediafiles/ directory or If removed, the nginx webserver needs to be replaced by something else that servers the /mediafiles/ directory or
`GUNICORN_MEDIA` needs to be enabled to allow media serving by the application container itself. `GUNICORN_MEDIA` needs to be enabled to allow media serving by the application container itself.
## User Creation ## How can I create users?
To create a new user click on your name (top right corner) and select system. There click on invite links and create a new invite link. To create a new user click on your name (top right corner) and select system. There click on invite links and create a new invite link.
It is not possible to create users through the admin because users must be assigned a default group and space. It is not possible to create users through the admin because users must be assigned a default group and space.
@ -28,7 +28,7 @@ To change a users space you need to go to the admin and select User Infos.
If you use an external auth provider or proxy authentication make sure to specify a default group and space in the If you use an external auth provider or proxy authentication make sure to specify a default group and space in the
environment configuration. environment configuration.
## Spaces ## What are spaces?
Spaces are a feature used to separate one installation of Tandoor into several parts. Spaces are a feature used to separate one installation of Tandoor into several parts.
In technical terms it is a multi tenant system. In technical terms it is a multi tenant system.
@ -39,11 +39,16 @@ If you want to host the collection of your friends family or your neighbor you c
Sharing between spaces is currently not possible but is planned for future releases. Sharing between spaces is currently not possible but is planned for future releases.
## Create Admin user / reset passwords ## How can I reset passwords?
To create a superuser or reset a lost password if access to the container is lost you need to To reset a lost password if access to the container is lost you need to
1. execute into the container using `docker-compose exec web_recipes sh`
2. activate the virtual environment `source venv/bin/activate`
3. run `python manage.py changepassword <username>` and follow the steps shown.
## How can I add an admin user?
To create a superuser you need to
1. execute into the container using `docker-compose exec web_recipes sh` 1. execute into the container using `docker-compose exec web_recipes sh`
2. activate the virtual environment `source venv/bin/activate` 2. activate the virtual environment `source venv/bin/activate`
3. run `python manage.py createsuperuser` and follow the steps shown. 3. run `python manage.py createsuperuser` and follow the steps shown.
To change a password enter `python manage.py changepassword <username>` in step 3.