Skip to content

Package Manager

Repository Installation

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 "deb [arch=`dpkg --print-architecture` signed-by=/etc/apt/keyrings/sagernet.asc] https://deb.sagernet.org/ * *" | \
  sudo tee /etc/apt/sources.list.d/sagernet.list > /dev/null
sudo apt-get update
sudo apt-get install sing-box # or sing-box-beta

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

sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://sing-box.app/sing-box.repo
sudo yum install sing-box # or sing-box-beta

Manual Installation

bash <(curl -fsSL https://sing-box.app/deb-install.sh)

bash <(curl -fsSL https://sing-box.app/rpm-install.sh)

bash <(curl -fsSL https://sing-box.app/arch-install.sh)

Managed Installation

Type Platform Command Link
AUR Arch Linux ? -S sing-box AUR package
nixpkgs NixOS nix-env -iA nixos.sing-box nixpkgs unstable package
Homebrew macOS / Linux brew install sing-box Homebrew package
APK Alpine apk add sing-box Alpine Linux Edge package
Type Platform Command Link
Homebrew macOS brew install sing-box Homebrew package
Type Platform Command Link
Scoop Windows scoop install sing-box Scoop package
Chocolatey Windows choco install sing-box Chocolatey package
winget Windows winget install sing-box winget package
Type Platform Command Link
Termux Android pkg add sing-box Termux package
Type Platform Command Link
FreshPorts FreeBSD pkg install sing-box FreeBSD port

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