logo

Install

Binary release (GitLab)

Intel x64 (Linux)

Download the latest binary release for Linux x64

curl -L -o ~/.local/bin/caracal https://gitlab.com/cipres/caracal/-/releases/continuous-master/downloads/caracal
chmod +x ~/.local/bin/caracal

ARM64 (Linux)

Download the latest binary release for Linux ARM64

curl -L -o ~/.local/bin/caracal https://gitlab.com/cipres/caracal/-/releases/continuous-master/downloads/caracal-arm64
chmod +x ~/.local/bin/caracal

AppImage

AppImage

This AppImage is based on the Lagrange browser (v1.18.4). It bundles and runs caracal for you, making it the easiest way to get started if you use Linux.

It runs caracal on port 1985 to avoid conflicts.

Download the AppImage.

curl -L -o caracal-x86_64.AppImage https://gitlab.com/cipres/caracal/-/releases/continuous-master/downloads/caracal-x86_64.AppImage
chmod +x ./caracal-x86_64.AppImage
./caracal-x86_64.AppImage

Windows

Download caracal for Windows (x64).

Cargo

cargo install caracal

Run it:

caracal

Then go to gemini://localhost in your Gemini browser.

If needed, you can change the listen port (which is 1965 by default) using the -p option.

caracal -p 1995

Use -l to set the listen address, and --cert-cn to set the certificate Common Name (CN).