The Linux agent is currently supported by the distributions detailed below. While the agent may work on other Linux distributions, Atera does not guarantee it — nor does it provide any support, bug fixes, or security patches for Linux devices running alternative distributions.
Supported Linux distributions:
- Debian 11 (and above)
- Ubuntu 18 (and above)
Additional requirements:
Your Linux device must have the following installed and enabled before you can use the Atera agent:
Network Settings
If after following the instructions for agent installation, you are experiencing any problems with the agent please verify that you:
- Allow outbound traffic over ports 443 and 8883 (TCP/UDP) in the Antivirus, Firewall, and Proxy servers.
List of servers that the agent is communicating with, make sure to have these servers whitelisted on your network.
- pubsub.atera.com
- pubsub.pubnub.com
- app.atera.com
- agenthb.atera.com
- packagesstore.blob.core.windows.net
- ps.pndsn.com
- agent-api.atera.com
- cacerts.thawte.com
- agentreportingstore.blob.core.windows.net
- atera-agent-heartbeat.servicebus.windows.net
- ps.atera.com
- atera.pubnubapi.com
- appcdn.atera.com
- atera-agent-heartbeat-cus.servicebus.windows.net
- ticketingitemsstoreeu.blob.core.windows.net
- download.visualstudio.microsoft.com
- a32dl55qcodech-ats.iot.eu-west-1.amazonaws.com
- agentspoliciesprod.blob.core.windows.net
Potential software/devices for blockage
-
Firewall - In some networks HTTPS traffic is blocked. Make sure to add a rule to allow HTTPS traffic from LAN to WAN (Atera address: agent-api.atera.com).
In some cases, HTTPS inspection (Deep Packet Inspection/SSL Inspection) can also cause blockages, make sure to disable HTTPS scanning or add Atera and its servers to the whitelist.
Note: The Great Firewall of China is blocking some of the servers required by the AteraAgent to report the device's availability (online/offline status). Therefore, machines that are located in this country will not be manageable from the console. Using a VPN connection may override these restrictions, however, we cannot provide specific instructions or support for setting up such configurations. -
Proxy - Proxy / Web-filtering is very common and can also be an obstacle to stable agent behavior. Make sure to permit outbound traffic (ports 443 and 8883) and file extensions; ZIP & EXE from our website (Atera address: agent-api.atera.com).
Note: Atera does not offer assistance or provisions for proxy configuration. - Geo-blocking - As an example, SonicWall routers are well known for their Geo-Blocking features.
- Permit content traffic in addition to TCP (443 and 8883) traffic.
Linux agent does not start after reboot
In cases where your Linux agent does not start after a reboot, and you receive the following errors.
1. Go to /etc/systemd/system/ and edit the file AteraAgent.service.
2. In the [Service] section, add the following line:
StartLimitIntervalSec=0
3. Reboot the device, after that the agent will start automatically.
Uninstalling the Linux agent
You must run this command in the Terminal to remove the Atera agent from your Linux device.
/usr/lib/atera-agent/uninstall.sh
Once you have removed the agent from your device you can delete the agent from within Atera. This can be done in one of two ways.
To delete the agent from the Devices page:
1. From Devices (on the sidebar), check the device.
2. Click the ellipses icon () at the top of the page and select Delete from the dropdown menu.
To delete the agent from the Agent Console:
1. From Devices (on the sidebar), select your device. The Agent Console appears.
2. Click Edit on the top right of the page.
3. Select Delete from the dropdown menu.
We are continuously working to improve the Linux Agent with new features — including the ability to run scripts and utilize AnyDesk remote access — so check back for updates! If you have any questions or run into any issues regarding the Linux Agent, please contact support
Failed to start AteraAgent.service
To resolve the issue of the Atera agent failing to start on your Linux device, you may need to install the libicu-dev package. This package provides necessary development files for International Components for Unicode (ICU), which might be required for the Atera agent to function correctly.
Follow these steps:
1. Open Terminal: Access the terminal on your Linux device.
2. Install libicu-dev: Run the following command to install the necessary package:
sudo apt-get install libicu-dev
3. Reinstall Atera Agent: Once the installation of libicu-dev is complete, attempt to install the Atera agent again.
This should resolve the issue of the Atera agent failing to start due to missing dependencies. If the problem persists, ensure that your system meets all other prerequisites for the Atera agent and consult the documentation or support for further assistance.
