Skip to content

Installation

Chokri Hammedi edited this page Aug 2, 2026 · 1 revision

Installation

Wirecat currently targets Linux/POSIX systems. The first release provides a Debian package, a standalone Linux amd64 archive, and a source archive.

Release Downloads

Download release assets from:

https://github.com/blue0x1/wirecat/releases/latest

Version 0.1.0 assets:

  • wirecat_0.1.0-1_amd64.deb
  • wirecat-0.1.0-linux-amd64.tar.gz
  • wirecat-0.1.0-source.tar.gz
  • SHA256SUMS

Debian, Kali, Ubuntu

Install the local package:

sudo apt install ./wirecat_0.1.0-1_amd64.deb
wcat --version

If apt reports missing dependencies, update package metadata and retry:

sudo apt update
sudo apt install ./wirecat_0.1.0-1_amd64.deb

Standalone Archive

Extract and install the binary:

tar -xzf wirecat-0.1.0-linux-amd64.tar.gz
sudo install -m 0755 wirecat-0.1.0-linux-amd64/wcat /usr/local/bin/wcat
wcat --version

Build From Source

Install build dependencies:

sudo apt install build-essential pkg-config libssl-dev

Build and test:

make
make test

Useful build targets:

make CC=clang
make debug
make asan
make analyze
make fuzz-harness
make clean

OpenSSL And QUIC

TLS support requires OpenSSL development headers and libraries.

QUIC support requires an OpenSSL build that exposes the OpenSSL QUIC APIs. If Wirecat is built against an OpenSSL version without those APIs, the --quic option remains visible but returns a clear runtime error.

Windows

Windows is not supported in 0.1.0. Core TCP, UDP, TLS, proxy, and file transfer support may be portable later, but POSIX PTY, Unix domain socket, SCTP, VSOCK, and Debian packaging behavior are Linux/POSIX-focused.

Clone this wiki locally