A remote monitoring & management tool, built with Django, Vue and Go.
Go to file
wh1te909 a3cf3c56bd update reqs 2020-04-19 04:58:52 +00:00
_modules ton of improvements to checks 2020-04-05 10:03:10 +00:00
api/tacticalrmm update reqs 2020-04-19 04:58:52 +00:00
docker fix logintoken not working in docker wh1te909/tacticalrmm#8 2020-04-16 05:44:17 +00:00
docs/screenshots add installation instructions and modify install script 2020-02-16 00:19:57 +00:00
scripts simplify remote agent uninstall 2020-03-28 09:54:42 +00:00
web update reqs 2020-04-19 04:58:52 +00:00
.gitignore Initial Commit 2020-04-06 17:36:50 -04:00
.travis.yml update reqs 2020-01-17 07:15:13 +00:00
LICENSE use present for copyright range 2020-03-28 20:21:49 +00:00
README.md change badge branch 2020-03-28 10:19:45 +00:00
azure-pipelines.yml attempt 1 at fixing pipelines tests 2020-04-16 05:44:17 +00:00
install.sh fix logintoken not working in docker wh1te909/tacticalrmm#8 2020-04-16 05:44:17 +00:00
update.sh copy scripts when updating 2020-03-28 10:11:21 +00:00

README.md

Tactical RMM

Build Status Build Status License: MIT Code style: black

Tactical RMM is a remote monitoring & management tool for Windows computers, built with Django and Vue.
It uses an agent written in python, as well as the SaltStack api and MeshCentral

Tactical RMM is currently in alpha and subject to breaking changes. Use in production at your own risk.

Features

  • Teamviewer-like remote desktop control
  • Real-time remote shell
  • Remote file browser (download and upload files)
  • Remote command and script execution
  • Event log viewer
  • Services management
  • Windows patch management
  • Automated checks with email/SMS alerting (cpu, disk, memory, services, event logs)
  • Remote software installation via chocolatey
  • Software and hardware inventory

Server Requirements

  • Any modern linux distro (an install script is provided for Ubuntu Server 18.04)
  • A domain you own with at least 3 subdomains
  • Google Authenticator app (2 factor is NOT optional)

Windows versions supported

  • 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

The install script will begin installing stuff. When it gets to this step, create the django superuser account:

Screenshot

Download the Google Authenticator app on your smartphone and scan the barcode that is generated:

Screenshot

Once the install has finished, navigate to your meshcentral site
https://mesh.tacticalrmm.com

Screenshot

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

Now create a device group. Name it whatever you want:

Screenshot

Click on "add one" and download the 64bit Mesh Agent:

Screenshot

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

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

Choose the client and site, enter a description of the computer and then install:

Screenshot

Once installation finished, check the website and you will see your computer appear in the dashboard.