Swif-agent is Swif's lightweight endpoint management agent for Linux devices. Installing swif-agent through your system’s package repository is the recommended approach for most organizations and developers. This method ensures seamless updates, easier dependency management, and smooth integration with your existing package workflows.

Key Features

Automated Device Enrollment: Easily enroll Linux devices into Swif's MDM platform using a single command.
Service Management: Automatically sets up and manages the swif-agent and syscheck services for device monitoring and compliance.
Repository-Based Updates: Receive the latest agent updates directly through your package manager, reducing manual maintenance.
Multi-Distribution Support: Official repositories are available for Debian/Ubuntu, Fedora/RHEL, and Arch-based distributions.
Secure and Flexible: Supports team-based enrollment and can be integrated into automated deployment pipelines.

Installation Instructions

DEB package for x64 and arm64

1) Download & install Swif APT public key

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

Check if it is installed:

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

2) Add the Swif repo to APT sources

Global:

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

EU:

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

3) Update Package List

Run the following command to update the package list:

sudo apt update

4) Install the Package

If the update is successful, install the Swifteam package:

sudo apt install swifteam

RPM/YUM package for x64 and arm64

1) Add Repository to YUM

Create a repository configuration file in /etc/yum.repos.d/. For example:

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

Add the following content to the file:

Global:

For x64 or 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

For arm64 or 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:

For x64 or 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

For arm64 or 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

Save and exit the file.

2) Clean YUM Cache

Run the following command to clear and update the YUM cache:

sudo yum clean all  
sudo yum makecache

3) Install the RPM Package

Install the package from the repository:

sudo yum install swifteam

This will fetch the latest version of the swifteam package from your configured repository and install it.

4) Verify the Installation

After installation, verify that the package is installed:

rpm -qi swifteam

This will display the package details, including the version and architecture.

ARCH (Pacman) package for x86_64 and aarch64

1) Add the Swif's Stable Repository

On the target Arch / Manjaro / EndeavourOS system:

curl -fsSL http://swif-linux-package.s3.amazonaws.com/swif-repo-public.asc \
  | sudo pacman-key --add -

Now locally trust (sign) the key:

sudo pacman-key --lsign-key 0CCCC3E539008F30

Edit your /etc/pacman.conf as root (or use sudo).
Global:
For x86_64:

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

EU:
For x86_64:

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

Save the changes and exit.

2) Update Pacman and Install

Refresh the package databases:
```
sudo pacman -Syy
```
This forces Pacman to fetch the latest package lists from the new [swif-linux-package] repo.
Install Swifteam:
```
sudo pacman -S swifteam
```

3) Verify the Installation

To confirm that Swif is installed, run:

swifteam --version

Additional Notes

After enrollment, your device should appear in the Swif.ai dashboard.
For advanced usage, troubleshooting, or to automate enrollment (e.g., in imaging or provisioning scripts), message support@swif.ai.
If you encounter issues, check the status of the swif-agent and syscheck services, and consult your team administrator for the correct teamId. The team ID can be found at Settings > Team page.