diff --git a/docs/docs/faq.md b/docs/docs/faq.md index 6a0060af..7bca4bcc 100644 --- a/docs/docs/faq.md +++ b/docs/docs/faq.md @@ -10,29 +10,9 @@ Linux / Mac agents are currently under development. Yes, you will just need to setup local DNS for the 3 subdomains, either by editing host files on all your agents or through a local DNS server. #### I am locked out of the web UI. How do I reset my password? -SSH into your server and run these commands: - -!!!note - The code below will reset the password for the account that was created during install. - To reset a password for a different user, you should use the web UI (see the next question below), but can also do so through the command line by replacing
- `#!python user = User.objects.first()`
- with
- `#!python user = User.objects.get(username='someuser')` -
- in the code snippet below. - - -```python -tactical@tacrmm:~$ /rmm/api/env/bin/python /rmm/api/tacticalrmm/manage.py shell -Python 3.9.2 (default, Feb 21 2021, 00:50:28) -[GCC 9.3.0] on linux -Type "help", "copyright", "credits" or "license" for more information. -(InteractiveConsole) ->>> from accounts.models import User ->>> user = User.objects.first() ->>> user.set_password("superSekret123") ->>> user.save() ->>> exit() +SSH into your server and run: +```bash +/rmm/api/env/bin/python /rmm/api/tacticalrmm/manage.py reset_password ```
@@ -42,17 +22,7 @@ From the web UI, click **Settings > User Administration** and then right-click o ![reset2fa](images/reset2fa.png)

Or from the command line:
-```python -tactical@tacrmm:~$ /rmm/api/env/bin/python /rmm/api/tacticalrmm/manage.py shell -Python 3.9.2 (default, Feb 21 2021, 00:50:28) -[GCC 9.3.0] on linux -Type "help", "copyright", "credits" or "license" for more information. -(InteractiveConsole) ->>> from accounts.models import User ->>> user = User.objects.get(username='someuser') ->>> user.totp_key = None ->>> user.save(update_fields=['totp_key']) ->>> exit() +```bash +/rmm/api/env/bin/python /rmm/api/tacticalrmm/manage.py reset_2fa ``` -
Then simply log out of the web UI and next time the user logs in they will be redirected to the 2FA setup page which will present a barcode to be scanned with the Authenticator app. diff --git a/docs/docs/restore.md b/docs/docs/restore.md index 188486e0..83d729fc 100644 --- a/docs/docs/restore.md +++ b/docs/docs/restore.md @@ -11,7 +11,7 @@ Add it to the sudoers group and setup the firewall. Refer to the [installation instructions](install_server.md) for steps on how to do all of the above. #### Change DNS A records -Open the DNS manager of whever your domain is hosted. +Open the DNS manager of wherever your domain is hosted. Change the 3 A records `rmm`, `api` and `mesh` and point them to the public IP of your new server. diff --git a/docs/docs/troubleshooting.md b/docs/docs/troubleshooting.md index 31f5d15e..3f34fc0c 100644 --- a/docs/docs/troubleshooting.md +++ b/docs/docs/troubleshooting.md @@ -51,9 +51,16 @@ This will print out a ton of info. You should be able to see the error from the Please then copy/paste the logs and post them either in our [Discord support chat](https://discord.gg/upGTkWp), or create a [github issue](https://github.com/wh1te909/tacticalrmm/issues). +
#### Web UI frozen or not loading / website errors / general errors +First, run the [update script](update_server.md#updating-to-the-latest-rmm-version) with the `--force` flag.
This will fix permissions and reinstall python/node packages that might have gotten corrupted. + +```bash +./update.sh --force +``` + Check all the systemd services that the rmm uses to function and check to make sure they're all active/running and enabled: ```bash