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.
Webpage Customization
Agent Customization
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!
Naming the Agent Service
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:
