master bs.1
BS(1) General Commands Manual BS(1)

bs — a shell script for easier use of sing-box core

bs index | cfg-name
, --list
list available configs and their index
, --current
show the currently used config
, --stop
stop the sing-box service and clean up

place your configs in /etc/sing-box/list/ as individual json files. you most likely don't have the said directory. (the script should throw an error if you don't)

the selected config is symlinked to /etc/sing-box/config.json

the sing-box-openrc package on Alpine should provide the required service. if not, write your own.

this was written for OpenRC, so no other init systems are supported. you're free to change this script locally as you wish.

rc-service(8), ln(1), creating a config

merc <merc@4plt.ch>

August 1, 2026 Linux 6.18.35-0-lts