Skip to content

# Package Manager

##
Repository Installation

Debian / APT
Redhat / DNF 5
Redhat / DNF 4

    sudo mkdir -p /etc/apt/keyrings &&
       sudo curl -fsSL https://sing-box.app/gpg.key -o /etc/apt/keyrings/sagernet.asc &&
       sudo chmod a+r /etc/apt/keyrings/sagernet.asc &&
       echo '
    Types: deb
    URIs: https://deb.sagernet.org/
    Suites: *
    Components: *
    Enabled: yes
    Signed-By: /etc/apt/keyrings/sagernet.asc
    ' | sudo tee /etc/apt/sources.list.d/sagernet.sources &&
       sudo apt-get update &&
       sudo apt-get install sing-box # or sing-box-beta

    sudo dnf config-manager addrepo --from-repofile=https://sing-box.app/sing-box.repo &&
    sudo dnf install sing-box # or sing-box-beta

    sudo dnf config-manager --add-repo https://sing-box.app/sing-box.repo &&
    sudo dnf -y install dnf-plugins-core &&
    sudo dnf install sing-box # or sing-box-beta

##
Manual Installation

The script download and install the latest package from GitHub releases for deb or rpm based Linux distributions, ArchLinux and OpenWrt.

    curl -fsSL https://sing-box.app/install.sh | sh

or latest beta:

    curl -fsSL https://sing-box.app/install.sh | sh -s -- --beta

or specific version:

    curl -fsSL https://sing-box.app/install.sh | sh -s -- --version <version>

##
Managed Installation

Linux
macOS
Windows
Android
FreeBSD

Type | Platform | Command | Link
--- | --- | --- | ---
AUR | Arch Linux | `? -S sing-box` |
nixpkgs | NixOS | `nix-env -iA nixos.sing-box` |
Homebrew | macOS / Linux | `brew install sing-box` |
APK | Alpine | `apk add sing-box` |
DEB | AOSC | `apt install sing-box` |

Type | Platform | Command | Link
--- | --- | --- | ---
Homebrew | macOS | `brew install sing-box` |

Type | Platform | Command | Link
--- | --- | --- | ---
Scoop | Windows | `scoop install sing-box` |
Chocolatey | Windows | `choco install sing-box` |
winget | Windows | `winget install sing-box` |

Type | Platform | Command | Link
--- | --- | --- | ---
Termux | Android | `pkg add sing-box` |

Type | Platform | Command | Link
--- | --- | --- | ---
FreshPorts | FreeBSD | `pkg install sing-box` |

##
Problematic Sources

Type | Platform | Link | Promblem(s)
--- | --- | --- | ---
DEB | AOSC | aosc-os-abbs | Problematic build tag list modification
Homebrew | / | homebrew-core | Problematic build tag list modification
Termux | Android | termux-packages | Problematic build tag list modification
FreshPorts | FreeBSD | FreeBSD ports | Old Go (go1.20)

If you are a user of them, please report issues to them:

1. Please do not modify release build tags without full understanding of the related functionality: enabling non-default labels may result in decreased performance; the lack of default labels may cause user confusion.
2. sing-box supports compiling with some older Go versions, but it is not recommended (especially versions that are no longer supported by Go).

##
Service Management

For Linux systems with systemd, usually the installation already includes a sing-box service, you can manage the service using the following command:

Operation | Command
--- | ---
Enable | `sudo systemctl enable sing-box`
Disable | `sudo systemctl disable sing-box`
Start | `sudo systemctl start sing-box`
Stop | `sudo systemctl stop sing-box`
Kill | `sudo systemctl kill sing-box`
Restart | `sudo systemctl restart sing-box`
Logs | `sudo journalctl -u sing-box --output cat -e`
New Logs | `sudo journalctl -u sing-box --output cat -f`