2024-01-25 16:47:28 +00:00

2.9 KiB

FAQ

json config files

Any item in the config.json file starting with an underscore character are ignored.

Ignored

"_title": "MyServer"

Valid setting

"title": "MyServer"

json requires correct formatting, if in doubt copy/paste your json config into a web based format checker to make sure you have it right: https://duckduckgo.com/?va=j&t=hc&q=json+lint&ia=answer

Help! I've been hacked there are weird agents appearing in my MeshCentral Console

No, you haven't.

  1. Your agent installer was scanned by an antivirus.

  2. It didn't recognize the exe.

  3. You have the option enabled to submit unknown applications for analysis.

    AV Option1

  4. They ran it against their virtualization testing cluster.

  5. You allow anyone to connect to your server (you should look into techniques to hide your server from the internet).

  6. Here are some examples of what that looks like.

Can't login on server after first setup

You're sure you're typing in everything right, giving it 2FA code and can't login

TOTP is time sensitive, check your time/NTP and make sure it's right (on server and TOTP app device)! :)

Branding and Customization

You can brand and customize MeshCentral almost as much as you like without delving into the code, a few changes in the config.json file and uploading images can change the way your system looks. Read more here

!!!note You will need to reinstall the agent for agent customizations to take effect.

Mac Clients

You have to manually grant Mac permissions outside of the agent install process due to the MacOS security system under Security & Privacy > Privacy

To see the screen (otherwise you just see the menu bar, and otherwise blank)

To be able to transfer files

To be able to control keyboard and mouse

I'm using cloudflare and I'm getting a black screen but the mouse moves?

If you are using cloudflare for your DNS hosting and your remote screen is black, DONT PANIC!

Unfortunately, MeshCentral currently doesnt work with CloudFlares Proxy DNS Mode, so the remote agent devices have to connect directly to your MeshCentral Server instead of being proxied!

The fix is to simply disable the 'Proxy Status' to OFF inside your DNS A Record.

Simple follow the steps here

Once done, open your firewall for the port and agentPort ports of where your meshcentral is hosted, then restart your MeshCentral Server

The is currently a PINNED GitHub issue about this here