Skip to main content

Installing swif-agent via Linux Repository

Updated over a month ago

Swif-agent is Swifteam’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

For Debian/Ubuntu (DEB-based)

  1. Add the Swif repository

    echo "deb [trusted=yes] https://swif-linux-package.s3.ap-southeast-1.amazonaws.com/debian beta main" | sudo tee /etc/apt/sources.list.d/swifteam.list
  2. Install Swif

    sudo apt update
    sudo apt install swifteam
  3. Enroll your device

    sudo swifteam -doEnroll -teamId=<teamId>

    Replace <teamId> with your actual Swifteam team ID.

  4. Verify installation and services

    sudo systemctl status swif-agent.service
    sudo systemctl status syscheck.service

For Fedora/RHEL (RPM-based)

  1. Add the Swif repository

    sudo tee /etc/yum.repos.d/swifteam.repo <<EOF
    [swifteam]
    name=Swifteam Repository
    baseurl=https://swif-linux-package.s3.ap-southeast-1.amazonaws.com/fedora/beta/x86_64
    enable=1
    gpgcheck=0
    EOF
  2. Install Swif

    sudo dnf makecache
    sudo dnf install swifteam
  3. Enroll your device

    sudo swifteam -doEnroll -teamId=<teamId>
  4. Verify installation and services

    sudo systemctl status swif-agent.service
    sudo systemctl status syscheck.service

For Arch Linux

  1. Add the Swifteam repository
    Edit /etc/pacman.conf and add:

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

    sudo pacman -Sy
    sudo pacman -S swifteam
  3. Enroll your device

    sudo swifteam -doEnroll -teamId=<teamId>
  4. Verify installation and services

    sudo systemctl status swif-agent.service
    sudo systemctl status syscheck.service

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.

Did this answer your question?