Using the Web Console

EasyTier supports using the Web Console to manage EasyTier nodes, including viewing node status, configuring node parameters, viewing node logs, and more.

Register an Account

To use the Web Console for the first time, you need to register an account. Registration link.

Running EasyTier Node

If you want the EasyTier node to be managed by the Web Console, you need to specify the --config-server or -w parameter when starting, for example:

sudo ./easytier-core -w <your username>

Please replace <your username> with the username you registered on the Web Console.

If the terminal shows messages like "Connection successful" or "Connected to server", it means Easytier Core has successfully connected to the Web Console server.

Note

The Web backend identifies devices and persists configurations through machine unique codes. By default, EasyTier automatically obtains the machine unique code from the system. If the machine code acquisition fails, it may cause configuration loss after restart. It is recommended to use the --machine-id parameter to specify the machine code, for example:

sudo ./easytier-core -w <your username> --machine-id abc123

Please ensure the machine code is unique and unchanged across all devices. It is strongly recommended to manually specify the machine code in Docker environments.

Note

Only one EasyTier process on a machine can be managed by the Web Console. Having multiple processes may cause unexpected issues.

Note

You can specify the hostname displayed on the console using the --hostname <custom hostname> parameter.