Skip to main content

How to install the Pulseway agent on RaspberryPi (Raspbian)

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.

    • Select the ARMHF CPU architecture.

  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 endpoint, perform the following steps to install it:

Note: The commands below use sudo. If you are signed in as the root user, you can omit sudo.

  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

For example, if the downloaded file is named pulseway_armhf.deb, run:

sudo dpkg -i pulseway_armhf.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?