Troubleshooting
Stable release: 0.6.0 · Windows and Linux.
- Run System check (Settings → Service and log) first. It also runs by itself after a failed connection and shows the first finding under the error.
- No network at all with Lockdown on, and Rosetun does not open. This removes Lockdown without the service. In a terminal opened as administrator on Windows:
Use your own folder if you chose another. On Linux:& 'C:\Program Files\Rosetun\rosetun.exe' reset-firewall
Uninstalling Rosetun removes Lockdown too.sudo rosetun reset-firewall - The network is closed after an update or a crash, and
rosetun statussaysnetwork: held closed. Connect, or open it: Open network on the connection screen, orrosetun open-network. Without a working service, usereset-firewallas above. - A site does not open right after connecting: browsers keep their own DNS cache. Rosetun clears the Windows DNS cache when it connects and disconnects, but not theirs. Restart the browser.
- Another VPN client in TUN mode can prevent the tunnel from starting. Disconnect it and retry. A program that changes traffic, such as zapret, can disrupt the connection to the server: exclude the server addresses in its settings.
- Windows: "Windows still holds the tunnel of the last session". Windows kept the adapter of the previous session, which can happen after fast startup. Restart the computer and connect again.
- Linux: No access to the Rosetun service. Your account is not in the
rosetungroup yet, or your session started before it joined. Press Add me, or runsudo usermod -aG rosetun "$USER", and restart the computer. - Linux: the tunnel DNS is missing from systemd-resolved. Check that the service is running, then reconnect. With the tunnel connected,
resolvectl status rosetun0should show a DNS server for the link. Set up system DNS on Arch - Linux: Rosetun says another program changed the firewall rules.
nftables.serviceand firewalld can start withflush ruleset, which removes Rosetun's table. The service puts it back within seconds androsetun statussays when. If it saysfirewall rules: cannot be checked or put back, treat the network as unprotected and reconnect. - Linux: KDE programs do not use the proxy. Check that
~/.config/kioslaverchasProxyType=1under[Proxy Settings]and thatXDG_CURRENT_DESKTOPcontainsKDE; otherwise Rosetun shows the address to enter yourself. KDE programs read the settings again by a signal and Chromium watches the file; restart other programs. Therosetuncommand never changes these settings. - Linux: Without a connection subscriptions do not update under Lockdown. Rosetun started outside your desktop session, as the window says. Restart it from the desktop.
- A subscription update through VPN fails while connected. Check that the main server works and try the update again. Rosetun stops after a failed VPN request. Subscription updates
- Linux: the file dialog fails to open. Check that
xdg-desktop-portaland a backend for your desktop are installed. You can import and export rules through the clipboard. Linux support - TLS fragmentation works only for servers that Xray carries (VLESS, VMess, Trojan, Shadowsocks) and helps with some providers only. Hysteria2 and HTTP or SOCKS5 servers connect without it, and it is unavailable while Without Xray is selected.
- No network connection means the system has no working network, so the server is not to blame. Connecting fails at once. While connected, a short network change does not break the session; with Reconnect automatically on, Rosetun waits for the network and reconnects when it returns, and the kill switch keeps the internet closed meanwhile.
- Wi-Fi with a sign-in page (a hotel or a café) or a wrong clock with Lockdown on: the sign-in page cannot open and the system cannot set the time without the tunnel, and the tunnel cannot start without them. Turn Lockdown off for a moment, sign in or correct the clock, connect, and turn Lockdown on again.
- Lockdown leaves virtual machines without network. Confirmed for Hyper-V on Windows, and most likely WSL2, Docker Desktop, Windows Sandbox and Mobile hotspot as well; on Linux, virtual machines and containers on this computer without a Rosetun connection. Turn Lockdown off while you need them.
- Windows: the window fails to open or draws incorrectly after an update: quit Rosetun from the tray, then run
$env:ROSETUN_RENDERER='glow'; & 'C:\Program Files\Rosetun\rosetun-gui.exe'in PowerShell (adjust the path if needed). Use Collect report and send the report with a description of the problem. - Windows: setup stops because standard users can change a folder under
C:\Program Files\Rosetun. This usually follows Continue in File Explorer, which gives your account permanent access to a protected Rosetun folder such asdata. Uninstall Rosetun and install it again. To read the service log, use Collect report or an editor run as administrator instead.
Report a problem in Issues, with the steps and the error text. Attach Collect report (Settings → Service and log). On Linux the report includes the service log from the system journal when your account may read it (the groups adm and systemd-journal on Debian); otherwise it says so and asks for nothing as root. Then add the output below by hand, removing addresses, links and names first: unlike the report, these logs are not cleaned.
rosetun status
sudo journalctl -u rosetun-helper -b --no-pager
cat ~/.config/rosetun/rosetun-gui.log
Report a vulnerability privately: see SECURITY.md.