sing-box/docs/installation/package-manager.md

icon
material/package

Package Manager

:material-tram: Repository Installation

=== ":material-debian: Debian / APT"

```bash
sudo curl -fsSL https://deb.sagernet.org/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
```

=== ":material-redhat: Redhat / DNF"

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

=== ":material-redhat: CentOS / YUM"

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

:material-download-box: Manual Installation

=== ":material-debian: Debian / DEB"

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

=== ":material-redhat: Redhat / RPM"

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

=== ":simple-archlinux: Archlinux / PKG"

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

:material-book-lock-open: Managed Installation

=== ":material-linux: Linux"

| Type     | Platform      | Link                    | Command                      | Actively maintained |
|----------|---------------|-------------------------|------------------------------|---------------------|
| APK      | Alpine        | [sing-box][alpine]      | `apk add sing-box`           | :material-check:    |
| AUR      | Arch Linux    | [sing-box][aur] ᴬᵁᴿ     | `? -S sing-box`              | :material-check:    |
| nixpkgs  | NixOS         | [sing-box][nixpkgs]     | `nix-env -iA nixos.sing-box` | :material-check:    |
| Homebrew | macOS / Linux | [sing-box][brew]        | `brew install sing-box`      | :material-check:    |

=== ":material-apple: macOS"

| Type     | Platform | Link             | Command                 | Actively maintained |
|----------|----------|------------------|-------------------------|---------------------|
| Homebrew | macOS    | [sing-box][brew] | `brew install sing-box` | :material-check:    |

=== ":material-microsoft-windows: Windows"

| Type       | Platform           | Link                | Command                      | Actively maintained |
|------------|--------------------|---------------------|------------------------------|---------------------|
| Scoop      | Windows            | [sing-box][scoop]   | `scoop install sing-box`     | :material-check:    |
| Chocolatey | Windows            | [sing-box][choco]   | `choco install sing-box`     | :material-check:    |
| winget     | Windows            | [sing-box][winget]  | `winget install sing-box`    | :material-alert:    |

=== ":material-android: Android"

| Type       | Platform           | Link                | Command                      | Actively maintained |
|------------|--------------------|---------------------|------------------------------|---------------------|
| Termux     | Android            | [sing-box][termux]  | `pkg add sing-box`           | :material-check:    |

=== ":material-freebsd: FreeBSD"

| Type       | Platform | Link              | Command                | Actively maintained |
|------------|----------|-------------------|------------------------|---------------------|
| FreshPorts | FreeBSD  | [sing-box][ports] | `pkg install sing-box` | :material-alert:    |

:material-book-multiple: 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