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 |
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 |
|
|
|
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
Add Swif's public key:
curl -fsSL https://swif-linux-package.s3.amazonaws.com/swif-repo-public.asc \
| sudo pacman-key --add -Trust the key locally:
sudo pacman-key --lsign-key 0CCCC3E539008F30
Edit
/etc/pacman.confas 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_64EU:
[swif-linux-package-eu]
SigLevel = Required DatabaseOptional
Server = https://swif-linux-package.s3.ap-southeast-1.amazonaws.com/arch/main-eu/x86_64Save the file.
SigLevel = Required DatabaseOptionalmakes Pacman check that every Swif package is signed with the key you added and trusted above.
2) Install the package
Refresh the package databases, so Pacman picks up the Swif repository:
sudo pacman -Syy
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.comover 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
