Package Manager

Repository Installation

Debian / APT Redhat / DNF 5 Redhat / DNF 4

sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://apt.oixcloud3rd.akinokaede.com/gpg.key \
  | sudo tee /etc/apt/keyrings/oixcloud3rd.asc >/dev/null
sudo chmod 0644 /etc/apt/keyrings/oixcloud3rd.asc

echo '
Types: deb
URIs: https://apt.oixcloud3rd.akinokaede.com/
Suites: *
Components: *
Enabled: yes
Signed-By: /etc/apt/keyrings/oixcloud3rd.asc
' | sudo tee /etc/apt/sources.list.d/oixcloud3rd.sources >/dev/null

sudo apt-get update
sudo apt-get install sing-box # or sing-box-beta

sudo dnf config-manager addrepo --from-repofile=https://public.oixcloud3rd.akinokaede.com/oixcloud3rd.repo
sudo dnf install sing-box # or sing-box-beta

sudo dnf install -y dnf-plugins-core
sudo dnf config-manager --add-repo https://public.oixcloud3rd.akinokaede.com/oixcloud3rd.repo
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.oixcloud3rd.akinokaede.com/installation/tools/install.sh | sh

or latest beta:

curl -fsSL https://sing-box.oixcloud3rd.akinokaede.com/installation/tools/install.sh | sh -s -- --beta

or specific version:

curl -fsSL https://sing-box.oixcloud3rd.akinokaede.com/installation/tools/install.sh | sh -s -- --version <version>

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