Installation
Where to download and how to install on Windows, macOS and Linux
All builds are collected on the download page — along with file sizes and
permanent links of the form /releases/latest/download/<file>, which always point to the
latest regular version.
Windows
Download the .exe installer (x64) and run it. The installer asks for administrator
rights — it installs the app and the background service that TUN mode needs. There will be
no separate rights prompt for the service, either when you turn on TUN or when you
update: the service is updated together with the app.
The installer also adds Windows Firewall rules for both cores — without them the
system and mixed stacks in TUN don't let traffic through. More details in the
Connection section.
The builds are not yet signed with a certificate, so SmartScreen may show an "Unknown publisher" warning. Click "More info" → "Run anyway".
Portable build
Clod.Clash_x64_portable.zip works without installation: unpack it and run it.
The background service for TUN is not installed in this case — the app will ask for rights
when you turn on TUN. TUN is not available from a FAT/exFAT drive: the service cannot recognise
a copy on a drive without access rights — move the app folder to an NTFS drive. A copy run as
administrator brings TUN up from such a drive too, without the service. The portable build doesn't update itself: get the
new version from the download page.
macOS
Download the .dmg for your processor: Apple Silicon (aarch64) or
Intel (x64), and drag the app into "Applications". macOS 11 or
newer is required.
The builds are not signed with an Apple certificate, so on first launch macOS will say it cannot verify the app. Open System Settings → Privacy & Security, click "Open Anyway" at the bottom and confirm with your password. You only need to do this once: the app installs updates by itself, without this window. On macOS 15 and newer the "Open" item in the context menu no longer helps — only the settings route works.
If macOS says the app is damaged and should be moved to the Trash (this is how builds up to and including 0.1.11-alpha.2 open on Apple Silicon), remove the downloaded-from-the-internet flag from it:
xattr -dr com.apple.quarantine "/Applications/Clod Clash.app"TUN mode on macOS asks for the administrator password the first time you turn it on — once, to install the background service.
One-command install
Paste into "Terminal":
curl -fsSL https://mrvibecodic.github.io/clod-clash/install-macos.sh | bashThe script picks the build for your processor, downloads the latest regular version from GitHub, puts it into "Applications" and launches it. macOS doesn't flag a file downloaded from the terminal as downloaded from the internet, so there will be no verification window.
How the script works
The script is short, and you can read it before running it: open the address in a browser
or run curl -fsSL https://mrvibecodic.github.io/clod-clash/install-macos.sh | less.
Step by step, it:
- Checks that this is macOS and picks
Clod.Clash_aarch64.dmgfor Apple Silicon orClod.Clash_x64.dmgfor Intel. The processor is detected correctly even in a terminal running under Rosetta. - If Clod Clash is running, stops and asks you to close the app.
- Downloads the
.dmgof the latest regular version into a temporary folder using the same permanent GitHub link as the download page. - Mounts the image read-only, without a Finder icon, and copies the app from it into a temporary folder.
- Replaces
/Applications/Clod Clash.appwith the copied one. The administrator password is asked for only if your user account has no write access to "Applications". If the download or the copy failed, the previous version stays in place. - Unmounts the image, deletes the temporary files and launches the app.
The script doesn't change macOS security settings and doesn't touch other apps. It doesn't install the background service for TUN — the app installs it by itself the first time you turn on TUN. Settings and subscriptions are stored separately from the app, so running the script again simply installs a fresh version on top. The script doesn't install pre-release versions; those arrive through the update inside the app itself.
Linux
.deb (Debian, Ubuntu, Mint) and .rpm (Fedora, openSUSE) packages are available for
x86_64:
sudo apt install ./Clod.Clash_amd64.deb
# or
sudo dnf install ./Clod.Clash-x86_64.rpmOn systems with systemd the package registers the background service for TUN right away, so a password
is usually not asked for when you turn on TUN. If the service still doesn't respond, the app
will ask for rights through pkexec (polkit) — it must be installed.
What's next
Launch the app and add a subscription. How the app updates itself is covered in Updates.