Skip to main content

How to install the Pulseway agent on Debian Linux

Written by Paul Csiki

To download the Pulseway Agent, follow these steps:

  1. From the left navigation menu, go to Onboarding > Downloads.

  2. Click the download link for the installer that matches the endpoint’s operating system and architecture:

    • Select the DEB package type for Debian.

    • Select the appropriate CPU architecture, such as x64 or x86.

  3. Depending on the device and installer type, you may be prompted to select the Organization, Site, and Agent Group associated with the endpoint. Pulseway uses these values to generate a customized installer. Once the selections are complete, click Download.

  4. After the installer has been generated, you can download it directly to your computer or copy the download link to share with a customer or technician by email.

After you have downloaded the agent to the Debian endpoint, perform the following steps to install it:

  1. Open a terminal. You can also connect to the endpoint through SSH.

  2. Navigate to the directory containing the downloaded installer. For example:

cd ~/Downloads
  1. Install the package using the following command, replacing <installer-file> with the name of the downloaded file:

sudo dpkg -i <installer-file>.deb
  1. If the agent was not automatically registered during installation, run the Pulseway registration utility:

sudo pulseway-registration

When prompted, enter your Pulseway server name, such as:

acme.pulseway.com

Enter only the server name. Do not include https://.

The registration utility should already be available in the system path. If the command is not found, run it from its default location:

sudo /usr/sbin/pulseway-registration
  1. The Pulseway service should start automatically after installation. If it does not, start it manually:

sudo systemctl start pulseway

Configure the Pulseway agent

To modify the Pulseway agent configuration, open the config.xml file using a text editor such as Vim:

sudo vim /etc/pulseway/config.xml

Alternatively, you can use Nano:

sudo nano /etc/pulseway/config.xml

After making and saving your changes, restart the Pulseway service to apply the updated configuration:

sudo systemctl restart pulseway

For further assistance, contact Pulseway Support at support@pulseway.com.


Did this answer your question?