add installation instructions and modify install script

This commit is contained in:
wh1te909 2020-02-16 00:19:57 +00:00
parent a2f76c9094
commit e9dafced37
12 changed files with 103 additions and 6 deletions

104
README.md
View File

@ -31,4 +31,106 @@ It uses an [agent](https://github.com/wh1te909/winagent) written in python, as w
## Windows versions supported ## Windows versions supported
- Windows 7, 8.1, 10, Server 2008R2, 2012R2, 2016, 2019 - Windows 7, 8.1, 10, Server 2008R2, 2012R2, 2016, 2019
## Installation example (Ubuntu server 18.04 LTS)
Fresh VPS with latest updates\
login as root and create a user and add to sudoers group (we will be creating a user called tactical)
```
apt update && apt -y upgrade
adduser tactical
usermod -a -G sudo tactical
```
switch to the tactical user and setup the firewall
```
su - tactical
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow ssh
sudo ufw allow http
sudo ufw allow https
sudo ufw allow proto tcp from any to any port 4505,4506
sudo ufw enable && sudo ufw reload
```
Our domain for this example is tacticalrmm.com
In the DNS manager of wherever our domain is hosted, we will create three A records, all pointing to the public IP address of our VPS
Create A record ```api.tacticalrmm.com``` for the django rest backend\
Create A record ```rmm.tacticalrmm.com``` for the vue frontend\
Create A record ```mesh.tacticalrmm.com``` for meshcentral
Download the install script and run it
```
wget https://raw.githubusercontent.com/wh1te909/tacticalrmm/develop/install.sh
chmod +x install.sh
./install.sh
```
Enter the following values when prompted:
![Screenshot](docs/screenshots/install1.PNG)
The install script will begin installing stuff. When it gets to this step, create the django superuser account:
![Screenshot](docs/screenshots/install2.PNG)
Download the Google Authenticator app on your smartphone and scan the barcode that is generated:
![Screenshot](docs/screenshots/install3.PNG)
Once the install has finished, navigate to your meshcentral site\
https://mesh.tacticalrmm.com
![Screenshot](docs/screenshots/install4.PNG)
Create an account. Make sure to use the same username that you entered at the beginning of the install script when prompted for "meshcentral username"\
Create a strong password (does __not__ have to be the same as the django superuser account, recommend using a different password)
![Screenshot](docs/screenshots/install5.PNG)
Now create a device group. Name it whatever you want:
![Screenshot](docs/screenshots/install6.PNG)
Click on "add one" and download the 64bit Mesh Agent:
![Screenshot](docs/screenshots/install7.PNG)
You will now have a file named "meshagent64-tacticalrmm.exe" in your Downloads folder
Navigate to the rmm frontend in a new tab\
https://rmm.tacticalrmm.com
Login using the username and password you created during the install script for the django superuser\
Then enter the 6 digit code from your google authenticator app when prompted
You will be redirected to the initial setup page
Create your first client and site, then upload the ```meshagent64-tacticalrmm.exe``` from your downloads folder and click Finish:
![Screenshot](docs/screenshots/install8.PNG)
You will be taken to the homepage of the app
Now install the agent on a windows computer:
Download the latest release exe from https://github.com/wh1te909/winagent/releases
Run the installer as administrator
Make sure to use the backend api url when installing, not the frontend url\
Username and password is the same one you created for django superuser:
![Screenshot](docs/screenshots/install9.PNG)
Choose the client and site, enter a description of the computer and then install:
![Screenshot](docs/screenshots/install10.PNG)
Once installation finished, check the website and you will see your computer appear in the dashboard.

Binary file not shown.

After

Width:  |  Height:  |  Size: 12 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 16 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 4.2 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 15 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 177 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 6.9 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 100 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 56 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 7.5 KiB

View File

@ -567,8 +567,6 @@ print_green 'Installing certbot'
sudo add-apt-repository -y ppa:certbot/certbot sudo add-apt-repository -y ppa:certbot/certbot
sudo apt install -y certbot sudo apt install -y certbot
sudo ufw allow http
sudo ufw allow https
sudo systemctl stop nginx sudo systemctl stop nginx
print_green 'Getting https certs' print_green 'Getting https certs'
@ -577,9 +575,6 @@ sudo certbot certonly --standalone --agree-tos -m ${letsemail} --no-eff-email -d
sudo certbot certonly --standalone --agree-tos -m ${letsemail} --no-eff-email -d ${rmmdomain} sudo certbot certonly --standalone --agree-tos -m ${letsemail} --no-eff-email -d ${rmmdomain}
sudo certbot certonly --standalone --agree-tos -m ${letsemail} --no-eff-email -d ${frontenddomain} sudo certbot certonly --standalone --agree-tos -m ${letsemail} --no-eff-email -d ${frontenddomain}
sudo ufw delete allow http
sudo ufw delete allow https
sudo chown -R $USER:$GROUP /home/${USER}/.npm sudo chown -R $USER:$GROUP /home/${USER}/.npm
sudo chown -R $USER:$GROUP /home/${USER}/.config sudo chown -R $USER:$GROUP /home/${USER}/.config