Connecting a server
Installing the agent with one command and checking that the server appeared in the panel.
After this page you will have a server connected to the panel and ready to take projects.
What you need before you start
| What | How to check |
|---|---|
| The server fits | Ubuntu LTS or Debian 12 and newer, x86_64, systemd, root |
| The server is added in the panel | It is created in the Servers section and the panel printed the install command |
| The agent token and id | The panel prints them in the same command |
Steps
-
Open the Servers section in the panel and create a server. The panel prints a ready install command with the token and the id.
-
Run the command on the server as root. It downloads the script and the binary from
get.nolay.ruand verifies the checksum.
- Wait for the installation to finish. At the end the script prints the agent version and the state of the service.
- Go back to the panel. The server switches to Online within a few seconds after the service starts.
Manual check
Make sure the agent opened no inbound port:
Look at the service journal:
Updating and running again
Running the same script again updates the binary and the unit. The config /etc/nolay/agent.toml, the data in /var/lib/nolay and project containers are not touched.
If it did not work
| Symptom | Cause | What to do |
|---|---|---|
| The installation stops on the checksum | The checksum file did not download or the binary is damaged | Run the installation again and pass --sha256 explicitly |
| The server stays Offline | The agent cannot open an outbound connection to api.nolay.ru | Check the server network and the firewall rules for outbound connections |
| The service does not start | The config or the token are written incorrectly | Look at journalctl -u nolay-agent and run the installation again |
What next
Read What Nolay is and create the first project in the panel.