Skip to main content

How to install and configure Pulseway Linux agent on Ubuntu OS

Written by Paul Csiki

To download the Pulseway Agent, follow these steps:

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

  2. Locate the Linux installer and select the package that matches the endpoint:

    • For Ubuntu, select the DEB package type.

    • 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 Ubuntu 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
  3. Install the package using the following command, replacing <installer-file> with the name of the downloaded file:

    sudo dpkg -i <installer-file>.deb
  4. 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 be available from any directory. If the command is not found, run it from its default location:

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

    sudo systemctl start pulseway

Configure the Pulseway agent

To change the agent configuration, open the following file using a text editor such as Nano or Vim:

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?