Rooba
/
tacticalrmm
mirror of https://github.com/amidaware/tacticalrmm.git
1
1
Fork 0
Code Issues Packages Projects Releases Wiki Activity

update docs

This commit is contained in:
wh1te909 2021-02-25 07:55:13 +00:00
parent 83f9ee50dd
commit 4a6bcb525d
3 changed files with 13 additions and 36 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

40
docs/docs/faq.md
View File

@ -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<br/>
`#!python user = User.objects.first()`<br/>
with<br/>
`#!python user = User.objects.get(username='someuser')`
<br/>
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 <username>
```
<br/>
@ -42,17 +22,7 @@ From the web UI, click **Settings > User Administration** and then right-click o
![reset2fa](images/reset2fa.png)
<br/><br/>
Or from the command line:<br/>
```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 <username>
```
<br/>
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.

2
docs/docs/restore.md
View File

@ -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.

7
docs/docs/troubleshooting.md
View File

@ -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).
<br/>
#### 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. <br/>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