Skip to main content

Installing Swif's Linux MDM via Package Manager

swif-agent is Swif's endpoint management agent for Linux. Installing it from Swif's package repository is the recommended way for most organizations. Updates come through your package manager, along with the rest of the system's updates.

Benefit

What it means

Updates through your package manager

New agent versions arrive with your regular package updates

Several distributions

Repositories for Debian and Ubuntu, Fedora and RHEL, and Arch Linux

Background services

Sets up the swif-agent and syscheck services, for device management and compliance

Automation

Works in imaging, provisioning, and other automated deployment scripts


Before you start

Choose your region. Use the Global or EU repository, to match your Swif workspace. Each region has its own repository and package name:

Region

DEB package

RPM package

Arch package

Global

swifteam

swifteam

swifteam

EU

swifteam-eu

swifteam-eu

swifteam-eu

All downloads use HTTPS.


DEB package (Debian, Ubuntu), for x64 and arm64

1) Download and install Swif's public key

curl -fsSL https://swif-linux-package.s3.amazonaws.com/swif-repo-public.asc \
| gpg --dearmor \
| sudo tee /usr/share/keyrings/swif-archive-keyring.gpg > /dev/null

Check that it's installed:

gpg --show-keys /usr/share/keyrings/swif-archive-keyring.gpg

2) Add the Swif repository

Run the command for your region and processor.

Global, x64 (x86_64):

echo "deb [signed-by=/usr/share/keyrings/swif-archive-keyring.gpg, arch=amd64] \
https://swif-linux-package.s3.amazonaws.com/debian stable main" \
| sudo tee /etc/apt/sources.list.d/swif-linux-package.list

Global, arm64 (aarch64):

echo "deb [signed-by=/usr/share/keyrings/swif-archive-keyring.gpg, arch=arm64] \
https://swif-linux-package.s3.amazonaws.com/debian stable main" \
| sudo tee /etc/apt/sources.list.d/swif-linux-package.list

EU, x64 (x86_64):

echo "deb [signed-by=/usr/share/keyrings/swif-archive-keyring.gpg, arch=amd64] \
https://swif-linux-package.s3.amazonaws.com/debian-eu stable main" \
| sudo tee /etc/apt/sources.list.d/swif-linux-package.list

EU, arm64 (aarch64):

echo "deb [signed-by=/usr/share/keyrings/swif-archive-keyring.gpg, arch=arm64] \
https://swif-linux-package.s3.amazonaws.com/debian-eu stable main" \
| sudo tee /etc/apt/sources.list.d/swif-linux-package.list

3) Update the package list

sudo apt update

Older Debian and Ubuntu releases: if apt update says HTTPS isn't supported, run sudo apt install apt-transport-https ca-certificates, then try again. Current releases support HTTPS without it.

4) Install the package

Global:

sudo apt install swifteam

EU:

sudo apt install swifteam-eu


RPM package (Fedora, RHEL), for x64 and arm64

1) Add the Swif repository

Create a repository file:

sudo nano /etc/yum.repos.d/swif-linux-package.repo

Add the content for your region and processor, then save the file.

Global, x64 (x86_64):

[swifteam]
name=Swifteam Repository
baseurl=https://swif-linux-package.s3.amazonaws.com/fedora/main/x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://swif-linux-package.s3.amazonaws.com/RPM-GPG-KEY-swifteam.pub

Global, arm64 (aarch64):

[swifteam]
name=Swifteam Repository
baseurl=https://swif-linux-package.s3.amazonaws.com/fedora/main/aarch64
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://swif-linux-package.s3.amazonaws.com/RPM-GPG-KEY-swifteam.pub

EU, x64 (x86_64):

[swifteam]
name=Swifteam Repository
baseurl=https://swif-linux-package.s3.amazonaws.com/fedora/main-eu/x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://swif-linux-package.s3.amazonaws.com/RPM-GPG-KEY-swifteam.pub

EU, arm64 (aarch64):

[swifteam]
name=Swifteam Repository
baseurl=https://swif-linux-package.s3.amazonaws.com/fedora/main-eu/aarch64
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://swif-linux-package.s3.amazonaws.com/RPM-GPG-KEY-swifteam.pub

2) Refresh the package cache

sudo yum clean all
sudo yum makecache

3) Install the package

Global:

sudo yum install swifteam

EU:

sudo yum install swifteam-eu

On Fedora and newer RHEL releases, you can use dnf instead of yum.

4) Check the installation

Global:

rpm -qi swifteam

EU:

rpm -qi swifteam-eu

This shows the package's version and architecture.


Arch package (Arch Linux, Manjaro, EndeavourOS), for x86_64

1) Add the Swif repository

  1. Add Swif's public key:

    curl -fsSL https://swif-linux-package.s3.amazonaws.com/swif-repo-public.asc \
    | sudo pacman-key --add -
  2. Trust the key locally:

    sudo pacman-key --lsign-key 0CCCC3E539008F30
  3. Edit /etc/pacman.conf as root, and add the section for your region.

    Global:

    [swif-linux-package]
    SigLevel = Required DatabaseOptional
    Server = https://swif-linux-package.s3.ap-southeast-1.amazonaws.com/arch/main/x86_64

    EU:

    [swif-linux-package-eu]
    SigLevel = Required DatabaseOptional
    Server = https://swif-linux-package.s3.ap-southeast-1.amazonaws.com/arch/main-eu/x86_64
  4. Save the file.

    SigLevel = Required DatabaseOptional makes Pacman check that every Swif package is signed with the key you added and trusted above.

2) Install the package

  1. Refresh the package databases, so Pacman picks up the Swif repository:

    sudo pacman -Syy
  2. Install the package.

    Global:

    sudo pacman -S swifteam

    EU:

    sudo pacman -S swifteam-eu

3) Check the installation

swifteam --version


Next: enroll the device

Installing the package installs the agent. To enroll the device in your Swif workspace, follow Enroll Linux Devices. You'll need your Team ID, from Settings > Team in Swif.

After enrollment, the device appears in Swif's device list.


Troubleshooting

apt update fails with an HTTPS error

Install HTTPS support for APT, with sudo apt install apt-transport-https ca-certificates, then run sudo apt update again. This is only needed on older releases.

apt update or yum makecache can't find the repository

  • Check that the address in step 2 matches your region and processor.

  • Check that the device can reach swif-linux-package.s3.amazonaws.com over HTTPS, on port 443.

The package installed, but the device doesn't appear in Swif

  • Check that the device is enrolled, with the right Team ID. See Next: enroll the device.

  • Check that the agent's services are running:

    systemctl status swif-agent syscheck

Pacman says a Swif package has an invalid or unknown signature

Pacman checks Swif packages against Swif's key, which needs to be added and trusted first. Under Arch package > 1) Add the Swif repository, add and trust the key again, as in the first two steps. Then run sudo pacman -Syy, and install again.

I need help automating installation

For imaging, provisioning scripts, or other automation, contact support@swif.ai.


Related resources

Did this answer your question?