A complete web-based remote monitoring and management web site. Once setup you can install agents and perform remote desktop session to devices on the local network or over the Internet.
Go to file
Ylian Saint-Hilaire 5a8d853273 Merge pull request #1427 from petervanv/master
Dutch language update 0.5.46
2020-05-28 14:49:43 -07:00
agents Updated metadata and modified amt-lme to hook newListener for 'connect' because JS HECI is much faster than old implementation 2020-05-28 13:30:28 -07:00
amt Updated all MeshAgents. 2020-04-08 16:21:27 -07:00
docs Intial ADFS Quick Doc 2020-05-25 20:57:58 -05:00
emails Improved Korean translation. 2020-05-21 22:11:24 -07:00
public Improved Intel AMT KVM rendering speed. 2020-05-28 03:14:08 -07:00
translate Dutch language update 0.5.46 2020-05-28 19:13:17 +02:00
views User management improvements. 2020-05-27 18:26:54 -07:00
.gitignore Removed .greenlockrc 2019-12-23 14:44:20 -08:00
amt-ider.js Updated file headers. 2020-01-02 18:30:12 -08:00
amtevents.js Updated file headers. 2020-01-02 18:30:12 -08:00
amtscanner.js Added email validation login page. 2020-04-21 01:50:27 -07:00
amtscript.js Updated file headers. 2020-01-02 18:30:12 -08:00
apfserver.js Updated file headers. 2020-01-02 18:30:12 -08:00
certoperations.js Many updates to how agents connect, agent cert checking and tls on agent port. 2020-05-22 12:54:22 -07:00
common.js Fixed numeric password requirement check. 2020-05-01 23:53:32 -07:00
CreateSourcePackage.bat Initial main commit 2017-08-28 09:27:45 -07:00
db.js Added --removeaccount command to MeshCentral. 2020-05-26 12:46:48 -07:00
exeHandler.js Updated file headers. 2020-01-02 18:30:12 -08:00
interceptor.js Updated file headers. 2020-01-02 18:30:12 -08:00
letsEncrypt.js Fixed plugin version matching, 2-factor reuirement + skip, removed GreenLock completely. 2020-03-11 16:53:09 -07:00
LICENSE Updated file headers. 2020-01-02 18:30:12 -08:00
mcrec.js Fixed desktop & terminal recording. 2020-03-11 00:17:10 -07:00
meshaccelerator.js Added file context menu for device files. 2020-02-14 11:20:06 -08:00
meshagent.js Many updates to how agents connect, agent cert checking and tls on agent port. 2020-05-22 12:54:22 -07:00
meshcentral.js Improved server recovery commands. 2020-05-26 17:49:42 -07:00
MeshCentral.sln Initial main commit 2017-08-28 09:27:45 -07:00
MeshCentralServer.njsproj New MeshAgents (except macOS and FreeBSD + Many fixes + MessageBox feature. 2020-05-18 17:57:11 -07:00
meshctrl.js More work on cross-domain admin. 2020-05-27 17:23:38 -07:00
meshdesktopmultiplex.js Added CloudFlare Support, improved reverse-proxy HTTP header handling. 2020-05-21 21:25:11 -07:00
meshmail.js Bug fixes, added AmtWake to MeshCMD. 2020-05-13 00:27:31 -07:00
meshrelay.js Added CloudFlare Support, improved reverse-proxy HTTP header handling. 2020-05-21 21:25:11 -07:00
meshscanner.js Updated file headers. 2020-01-02 18:30:12 -08:00
meshsms.js Clean up. 2020-04-22 22:15:51 -07:00
meshuser.js User management improvements. 2020-05-27 18:26:54 -07:00
mpsserver.js Added basic auth.log support. 2020-02-17 10:24:32 -08:00
mqttbroker.js Improved CertURL certificate loading. 2020-03-19 13:42:37 -07:00
multiserver.js Updated file headers. 2020-01-02 18:30:12 -08:00
package.json Version 0.5.46 2020-05-27 18:40:39 -07:00
pass.js Added batch account addition. 2019-05-14 14:39:26 -07:00
plugin_development.md meshCentralCompat version comparison changes and updated docs for clarity 2020-03-11 21:22:06 -04:00
pluginHandler.js Fixed SAML issuer problem. 2020-05-25 00:09:35 -07:00
readme.md Fixed readme file. 2020-04-20 14:15:26 -07:00
redirserver.js Many fixes with desktop recording indexor and player. 2020-03-03 16:22:50 -08:00
reinstall-modules.bat Module dependency cleanup. 2019-03-25 11:32:16 -07:00
sample-config-advanced.json Version 0.5.46 2020-05-27 18:40:39 -07:00
sample-config.json Added filter bar to mobile web app. 2020-05-22 17:59:42 -07:00
SourceFileList.txt Improved MeshAgent and MeshCmd. 2018-01-25 16:12:53 -08:00
swarmserver.js Updated file headers. 2020-01-02 18:30:12 -08:00
webauthn.js Improved CertURL certificate loading. 2020-03-19 13:42:37 -07:00
webserver.js User management improvements. 2020-05-27 18:26:54 -07:00
winservice.js Updated file headers. 2020-01-02 18:30:12 -08:00

MeshCentral

For more information, visit MeshCommander.com/MeshCentral2. Discussion forum on Reddit.

Download the full PDF user's guide with more information on configuring and running MeshCentral2. In addition, the installation guide can help get MeshCentral installed on Amazon AWS, Microsoft Azure, Ubuntu or Raspberry Pi.

This is a full computer management web site. With MeshCentral, you can run your own web server to remotely manage and control computers on a local network or anywhere on the internet. Once you get the server started, create device group and download and install an agent on each computer you want to manage. A minute later, the new computer will show up on the web site and you can take control of it. MeshCentral includes full web-based remote desktop, terminal and file management capability.

To test this server, feel free to try MeshCentral.com.

Installation

Make sure you have NodeJS and npm installed. If you are behind a proxy, setup npm to use the proxy:

	npm config set proxy http://proxy.com:88
	npm config set https-proxy http://proxy.com:88

Then, install MeshCentral by creating an empty folder and using npm to download the module:

	mkdir meshcentral
	cd meshcentral
	npm install meshcentral

To run MeshCentral you may need to use nodejs instead of node on Linux.

	cd ./node_modules/meshcentral
	node meshcentral [arguments]

You can launch MeshCentral with no arguments to start it in LAN mode. In LAN mode only devices on the local network can be managed. To setup a more secure server, use --cert to specify an IP address or name that resolves to your server. This name will be used by agents to connect back to the server. So, make sure you set a name that will resolve back to your server. MeshCentral will not register this name for you. You must make sure to setup the DNS name yourself first, or use the right IP address. If you are just taking a quick look at MeshCentral, you can skip this step and do it at later time.

	node meshcentral --cert servername.domain.com
	node meshcentral --cert 1.2.3.4

On Windows, you can install MeshCentral to run as a background service, just run it using --install. Once running, open a browser and enter the server url. By default, a TLS self-signed certificate is created so you will need to ignore the security warning given by your browser. A link to the root certificate that can be loaded into your browser is provided on the website so you can make the warnings go away. You can run without TLS security using --notls, but this is not recommended.

Update and uninstall

Uninstalling MeshCentral is super easy, just use npm as usual. For updating, just install over the previous version by installing again, data files will not be changed. From the parent folder of node_module, enter ether:

	npm install meshcentral
	npm uninstall meshcentral

Command Line

Command line arguments on Windows only:

Arguments Description
--install Install MeshCentral as a background service.
--uninstall Uninstall MeshCentral background service.
--start Start MeshCentral as a background service.
--stop Stop MeshCentral background service.

Command line arguments on any platform:

Arguments Description
--notls Use HTTP instead of HTTPS for the main web server.
--user [username] Always login as [username] if the account exists.
--port [number] Web server port number (default is 443).
--mpsport [number] Intel AMT server port number (default is 4433).
--redirport [number] Redirection web server, redirects users to the HTTPS server (default to 80).
--exactports Server must run with correct ports or exit.
--cert [name], (country), (org) Create a web server certificate with a server name. Country and organization can optionaly be set.

Configuration File

As an alternative to using command line arguments, you can create a ./node-module/meshcentral-data/config.json file, for example:

	{
		"settings": {
			"port": 8080,
			"redirport": 81
		},
		"domains": {
			"": {
				"title": "MyServer",
				"title2": "Servername",
				"userQuota": 1048576,
				"meshQuota": 248576,
				"newAccounts" : 1
			},
			"Customer1": {
				"title": "Customer1",
				"title2": "Extra String",
				"newAccounts" : 0
			},
			"Customer2": {
				"title": "Customer2",
				"title2": "Other String"
			}
		}
	}

The settings part are for command line arguments. For example, instead of running with --port 8080, you can put "port": 8080 in the settings portion of the config.json file. In addition, you can use the config.json file to create multi-tenancy servers. In the domains section, you can set options for the default domain ("") in addition to creating new domains.

For the configuration above, the root domain and two other domains will be accessible like this:

	https://servername:8080/
	https://servername:8080/customer1
	https://servername:8080/customer2

When you setup many domains, the server considers each domain separately. Each domain has separate user accounts, administrators, etc. Within each domain, you can put a title and title2 as strings that will show up at the top of the web site. userQuota indicates the default maximum amount of data a user can have in it's "My Files" folder. meshQuota is the maximum total size of files in each mesh folder. newAccounts indicates if new accounts can be created from the login page, 0 if not allowed, 1 if allowed. Note that if a web site has no accounts, the new account option will be available until an account is created and the first account will be the site administrator.

Other Notes

For Windows users, if you install MeshCentral globally using npm install meshcentral -g, it will not be able to run correctly as a Windows Service. It will immediately stop each time you start it.

For more information on MeshCentral or other tools, visit MeshCommander.com.

Tutorials

How to install MeshCentral2 in a few minutes.
MeshCentral2 - Installation

Demonstration of MeshCentral2 usages and more tips & tricks.
MeshCentral2 - Usages

How to setup Intel® AMT client initiated remote access (CIRA) to connect to MeshCentral2.
MeshCentral2 - Intel AMT CIRA

License

This software is licensed under Apache 2.0.