Rosetun

WINDOWS LINUX OPEN SOURCE

Install

Stable release: 0.6.0 · Windows and Linux.

Requirements

Windows: Windows 11, x64. Windows 10 runs on one tester's computer; the failure tests have not run on it.

Linux: amd64 with systemd, nftables and cgroup v2. Debian 13 is the reference distribution. With polkit (pkexec, polkitd) you can change Lockdown in the app. You can also run sudo rosetun lockdown on or sudo rosetun lockdown off in a terminal.

Windows

Download rosetun-0.6.0-setup.exe from Releases. The installer is not code-signed yet; if SmartScreen says "Windows protected your PC", select More info and then Run anyway. See the code signing policy.

You can choose an installation folder, but not inside a user profile or where standard users can change it; the SYSTEM service requires a protected folder. Uninstalling keeps your configuration in %APPDATA%\Rosetun by default, or you can choose to delete your settings, subscriptions and rules.

Update: run the new installer over the old version. With the kill switch on, the network stays closed through the update, and the app starts and connects again. If it cannot connect, the connection screen offers Connect and Open network; rosetun open-network does the same. Lockdown stays on.

Debian / Ubuntu / Linux Mint

Distributions (amd64, glibc 2.36 or newer): Debian 13 is verified by the system test matrices. Ubuntu 24.04+, Linux Mint 22+ and other Debian/Ubuntu derivatives with this glibc or newer, systemd, nftables and polkit are expected to work with the same .deb; manual Ubuntu verification is pending.

Systems without systemd and Flatpak, Snap and AppImage packages are unsupported: Rosetun needs a privileged system service and access to the host firewall and TUN device.

Download rosetun_0.6.0_amd64.deb from Releases, verify it, install it and add yourself to the group that may reach the service:

sudo apt install ./rosetun_0.6.0_amd64.deb
sudo usermod -aG rosetun "$USER"

Then restart the computer. Logging out is not enough: your systemd user manager can outlive the logout and pass its old groups on to the programs it starts. If you skip the last command, the window offers the same with Add me.

Update: install the new package the same way. With the kill switch on, the network stays closed through the update: a running window restarts itself and connects again. Without a window, rosetun status says network: held closed, rosetun connect connects and rosetun open-network opens it. Lockdown stays on.

Remove: sudo apt remove rosetun takes Lockdown off first. If it cannot, the removal stops and Rosetun stays, so the network can still be opened.

Purge: sudo apt purge rosetun also removes the lists and state in /var/lib/rosetun. Your settings and autostart entry in your home folder (~/.config/rosetun) and the rosetun group stay.

Arch Linux

The Rosetun repository carries the rosetun-bin recipe. Review the recipe for the release before building on Arch.

git clone --branch v0.6.0 https://github.com/eoftgge/rosetun.git
cd rosetun
bash tools/arch/update-pkgbuild.sh v0.6.0
cd packaging/arch
makepkg -si
sudo systemctl enable --now rosetun-helper rosetun-lockdown
sudo usermod -aG rosetun "$USER"
sudo reboot

The package installs the release binaries with their matching sing-box and Xray builds.

System DNS in TUN mode

Enable systemd-resolved so sing-box can register the tunnel's DNS server with the system.

sudo systemctl enable --now systemd-resolved.service

If Rosetun is already connected, disconnect and connect again. Then check the DNS servers on the tunnel interface and try a system lookup.

resolvectl status rosetun0
timeout 5s getent ahosts example.org

The tunnel's DNS should appear under DNS Servers. If it appears but the lookup still fails, check that the system resolver uses systemd-resolved. The recommended /etc/resolv.conf setup for its local DNS stub is a symlink to /run/systemd/resolve/stub-resolv.conf. systemd-resolved manual

Update: update the package, then run sudo rosetun-helper-privileged --restart-for-upgrade. A normal systemctl restart opens the network with the kill switch on. The upgrade command preserves the hold until you reconnect or run rosetun open-network. Services are enabled by you, never by the package.

Remove: sudo pacman -R rosetun-bin. A transaction hook resets Lockdown before deleting files and refuses removal if that fails. To recover first: sudo rosetun reset-firewall. User settings and the group stay.

Validation status. The GUI has had a manual check on Arch. The automated Linux system matrices cover Debian 13.

Updating from 0.5

Before updating, copy your settings folder. The default path is %APPDATA%\Rosetun on Windows and ~/.config/rosetun on Linux. The backup contains your subscription URLs. Keep it private.

Use the update procedure for your platform above to carry over settings and Lockdown. The first settings save in 0.6 converts format 8 to format 9 and leaves the previous file beside it as config.v8.json. The 0.6 beta already uses format 9. Rosetun 0.5 refuses to open a format 9 file and leaves it intact.

Going back to 0.5.1

  1. Disconnect in 0.6 so your own proxy settings come back.
  2. Uninstall 0.6 and keep your settings. On Debian, use apt remove to retain data that apt purge would remove.
  3. Install 0.5.1 and close Rosetun.
  4. If your configuration was saved in format 9, restore a copy of your pre-update config.json. You can also copy config.v8.json to config.json in the settings folder if that backup exists. Keep a separate copy of the format 9 file if you want to retain your 0.6 changes.
  5. Re-enable autostart and Lockdown if you used them.

Verify the download

SHA256SUMS.txt in each release lists the installer and the package. For a release built from a tag, GitHub also holds a build provenance attestation for both. An attestation says which workflow built the file; it is not a code signature.

Windows:

Get-FileHash .\rosetun-0.6.0-setup.exe -Algorithm SHA256
gh attestation verify .\rosetun-0.6.0-setup.exe --repo eoftgge/rosetun

Debian:

sha256sum --check --ignore-missing SHA256SUMS.txt
gh attestation verify rosetun_0.6.0_amd64.deb --repo eoftgge/rosetun