How to Customize MeshCentral

MeshCentral includes several built-in ways to allow you to customize the branding and appearance of the agent and the web interface. This page will cover Many of those methods.

One of the more subtle customizations available is the ability to customize several parts of the agent that gets installed on remote computers. It is a little thing, but can make a big impression and help you or your company to appear much more polished!

The agentCustomization section in the domains config allows setting the agent's various IDs on the client side, and also allows running multiple agents (with different names).

In config.json:

{ "settings": {
  "domains": {
    "": {
      "Title": "Company MeshCentral",
      "agentCustomization": {
        "displayName": "MyCompany Agent",
        "description": "Allows MyCompany to provide full service remote support to this computer.",
        "companyName": "MyCompany IT",
        "serviceName": "MyCompany Remote Support Agent",
        "fileName": "MyCompanyAgent"
Config Field Used in…
displayName Service display name (Linux, Windows), Service uninstaller (Windows)
description A longer form description of the service.
companyName Name of company, also used in the install path of the agentService install parent folder (Linux, Windows)
serviceName Service ID/name (Linux, Windows)
fileName Name given to the executable file for the service

Note that three of these fields get used as parts of the path the agent gets installed to. Using the examples listed above, the install path for the agent would be:

C:\Program Files\MyCompany\MyCompany Remote Support Agent\MyCompanyAgent.exe

Linux Example:

● serviceName .service - displayName  Loaded: loaded (/lib/systemd/system/serviceName.service; enabled; vendor preset: enabled)
   Active: active (running) since Mon 2021-05-17 18:01:35 AWST; 3h 56min ago
 Main PID: 540 (meshagent)
    Tasks: 2 (limit: 2342)
   Memory: 9.9M
   CGroup: /system.slice/serviceName .service
           └─540 /usr/local/mesh_services/MyCompany/MyCompany Remote Support Agent/MyCompanyAgent --meshServiceName=serviceName --installedByUser=0

Windows Example:

  • howto/customization.txt
  • Last modified: 2021/05/17 15:11
  • by jjoelc