Adding the Host
This tutorial applies to both Windows and Linux machines, although typically Linux as Windows includes a desktop GUI. It is geared towards those familiar with the command line. Our Getting Started Guide is a good resource for how you would typically add a host from the host itself.
To begin, login to the Meshify Admin and click on the “Hosts” tab:

Then click “Add Host Manually”:

I’ve named the host “example.host”. What you enter here becomes the hostname in Meshify DNS, similar to the mesh name becoming the network interface name. This name will resolve in DNS if you have enabled Meshify DNS.
- Set the Public endpoint to your external IP address, followed by a colon, and then a port you pick for the server. Use 51820 for the port if you’re unsure. It’s also possible to use a hostname rather than an IP address, but it is always better to specify the actual IP address. If you do not know your external IP address, then go to Google and type “What is my IP address” and it will tell you.
- Set the listen port to the same port value
Configuring the Agent
You’re now ready to install the Linux agent. Visit https://ppa.meshify.app and follow the instructions:

sudo nano /etc/meshify/meshify-client.config.json
{
"MeshifyHost": "https://my.meshify.app",
"HostID": "",
"ApiKey": ""
}
# Update the HostID and ApiKey from your meshify control panel for the host.
Use the code block above to edit the configuration for the host.
You will need to enter the HostID and ApiKey into your Linux configuration. To do this, click on your host in the Meshify Admin, and then click on “Advanced Configuration”:

Copy and paste the HostGroup to the HostID value, and the Apikey as well.
{
"MeshifyHost": "https://my.meshify.app",
"HostID": "6cf79a1e-cc3e-4b87-b96a-c37246074763",
"ApiKey": "kKFWYC5TXJHqDLXcvGxYLdao4BQkT912"
}
Save your changes to complete the configuration, then follow the instructions to start the service.
Congratulations! You have created your first host manually!