radicle.xyz/_pages/download.md

title, subtitle, variant, binary, arch, preconnect, scripts

title	subtitle	variant	binary	arch	preconnect	scripts
Download Radicle	Download a Radicle release	wide	unknown-linux-musl apple-darwin	x86_64 aarch64	https://files.radicle.dev	download

This is Radicle's download page, which references various ways of downloading Radicle to your machine.

Package Manager

Note that all packages are maintained on a best-effort basis, it might take some time for them to catch up after a release. Thanks to all community members that help distributing Radicle!

Advanced Package Tool (and compatible)

To use our repository at <{{ site.url }}/apt>, first install the signing key:

curl -LO {{ site.url }}/apt/radicle-archive-keyring.deb
chmod a+r radicle-archive-keyring.deb
sudo apt install ./radicle-archive-keyring.deb

Then add the URL to your /etc/apt/sources.list:

echo "deb [signed-by=/usr/share/radicle/radicle-archive-keyring.asc] {{ site.url }}/apt release main" | sudo tee -a  "/etc/apt/sources.list"

Now install radicle, e.g.:

sudo apt-get install radicle

Pacman

Install radicle-bin from AUR.

Nix

Install radicle-node from Nixpkgs.

Reproducible Binary

Radicle uses a reproducible build pipeline to ensure that anyone can reproduce the binaries on this page from source.

{% for release in site.releases %} {% assign data = site.data.releases[release.id] %}

{{ release.name }} {{ data.version }}

Built from commit {{ data.commit }} on {{ data.timestamp | date_to_xmlschema }}.

{% for binary in page.binary %} {% for arch in page.arch %} {% if forloop.index == 1 %}{% endif %} {% endfor %} {% endfor %}

OS	Arch	💾 File
		Archive	Signature	Checksum
{% if binary == "apple-darwin" %}macOS{% else %}Linux{% endif %}	{{ arch }}	{{ release.id}}-{{ data.version }}-{{ arch }}-{{ binary }}.tar.xz	.sig	.sha256

{% for signer in release.signers %} {% assign info = site.data.author[signer].signing %} {% endfor %}

Signer
Key	{{ info.key }}
Fingerprint	{{ info.fingerprint }}
Owner	{{ info.email }}

{% endfor %}

Download

OS	Arch	Target
Linux	x86_64	x86_64-unknown-linux-musl
	aarch64 (ARM)	aarch64-unknown-linux-musl
macOS	x86_64	x86_64-apple-darwin
	aarch64 (ARM)	aarch64-apple-darwin

You can download the appropriate tarball for your operating system with:

curl -O -L https://files.radicle.dev/releases/latest/radicle-$TARGET.tar.xz

For Radicle proper, and:

curl -O -L https://files.radicle.dev/releases/radicle-httpd/latest/radicle-httpd-$TARGET.tar.xz

For Radicle HTTP Daemon.

Replace $TARGET with the appropriate target for your system, from the table above.

Verification

After you've downloaded the archive (ARCHIVE.tar.xz in the examples below), verify the signature using the .sig file and ssh-keygen. The output must match the following, including the respective signing key fingerprint from the section above. For example:

$ ssh-keygen -Y check-novalidate -n file -s ARCHIVE.tar.xz.sig < ARCHIVE.tar.xz
Good "file" signature with ED25519 key SHA256:iTDjRHSIaoL8dpHbQ0mv+y0IQqPufGl2hQwk4TbXFlw

To verify the checksum, download the .sha256 file, and run:

$ sha256sum -c ARCHIVE.tar.xz.sha256
ARCHIVE.tar.xz: OK

The output must correspond to the above.

Installation

To install, simply extract the files to a location in your PATH, for example:

$ tar -xvJf ARCHIVE.tar.xz --strip-components=1 -C ~/.radicle/

This will place binaries in ~/.radicle/bin and manuals in ~/.radicle/man, and overwrite any existing Radicle binaries.

<script> document.addEventListener('DOMContentLoaded', () => { {% for release in site.releases %} getRelease("{{ release.name }}", "{{ release.base }}", "{{ release.id }}", "{{ site.data.releases[release.id].timestamp }}"); {% endfor %} }); </script>