Getting Started

Getting Started

🌐 English · Русский · 中文

Install

Grab the latest build from the downloads page or the Releases page.

Windows

• Download the Installer — x64 for almost every PC, ARM64 only for Snapdragon / Surface Pro X.
• Run it. On first launch SlothClash installs a small helper service (needed for TUN) — approve the UAC prompt.
• If Windows prompts for the Visual C++ runtime, let it install.

macOS

• Download the .dmg — Apple Silicon for M1/M2/M3/M4 Macs, Intel for 2019-and-older Macs.
• Drag SlothClash to Applications and launch it.

Linux

Pick whatever fits your distro (amd64 or arm64):

Method	Command
Arch (AUR)	yay -S sloth-clash-bin
Debian / Ubuntu	add the apt repo (see the downloads page), then sudo apt install sloth-clash
Fedora / openSUSE	add the dnf repo, then sudo dnf install sloth-clash
AppImage	download, chmod +x, run
.deb / .rpm	download and install with your package manager

Add your subscription

Most people connect with a subscription URL from their provider.

1. Open the Profiles screen.
2. Click ＋ Add / Import.
3. Paste your subscription URL and confirm. SlothClash downloads the config and imports it as a profile.
   • You can also import from a file (a .yaml config), or paste raw share links (vless://, vmess://, ss://, trojan://, hysteria2://, tuic://).
4. Click the new profile to make it Active.

Subscriptions auto-update on their own interval. You can also refresh a profile manually at any time.

Connect

1. Choose how to route traffic (see Settings):
   • TUN mode (recommended) — captures all system traffic.
   • System-proxy mode — lighter, covers proxy-aware apps only.
2. Hit the Connect toggle.
3. On the first TUN connection the helper service brings up the virtual adapter — approve any prompt.
4. Status shows Connected. Traffic now routes through your active profile.

To disconnect, toggle it off.

At a glance

Screen	What it shows
Home / Dashboard	Connect toggle, live ↓/↑ speed, active profile, current node
Proxies	Groups and nodes — pick a server, health-check latency
Connections	Live connections with the exit node and its country flag
Profiles	Your subscriptions — add, update, activate
Settings	Mode, TUN stack, DNS, autostart, theme

Next steps

• Profiles & Nodes — manage subscriptions and choose servers
• Routing & Rules — decide what goes through the proxy
• Settings — TUN mode & stack, DNS, autostart