Installing and Upgrading
JoyDX is a single self-enclosed file ready to launch. If you are planning on using JoyDX to manage Podman for you, please read the Podman Section as it might be necessary to install some base tools for compatibility.
For your convenience, there is an installer script available to help you download and setup JoyDX up using the following snippet.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/joy-dx/installer/refs/heads/main/install.sh)" Download Details
The following table describes the various types of package available from the JoyDX Releases repository. Checksums and GPG signatures are available for verifying release integrity.
| Platform | Architecture | Webkit Version | Example Filename |
|---|---|---|---|
| MacOS | Apple Silicon (M1, M2, etc.) | joydx-darwin-arm64.zip | |
| MacOS | Intel Silicon | joydx-darwin-amd64.zip | |
| Linux | AMD64 | Version 4 | joydx-linux-amd64 |
| Linux | AMD64 | Version 4.1 | joydx-linux-amd64-webkit241 |
| Linux | ARM64 | Version 4 | joydx-linux-arm64 |
| Linux | ARM64 | Version 4.1 | joydx-linux-arm64-webkit241 |
Download Integrity
If you would like to verify the authenticity of your downloads, checksums and PGP signatures are available on the Github releases page. hen using the built in update function, both are automatically checked.
To retrieve a copy of the public PGP key used to sign compiled apps identified by simon@joydx.com, click here. If your PGP client supports Web Key Directory, this site is also configured to expose the key appropriately.
Linux Webkit
JoyDX was made possible thanks to the excellent Wails Toolkit. The versions of core libraries that JoyDX makes use of has experienced some breaking changes for most distributions starting around 2024.
To maximize availability of JoyDX for Linux, there are two versions available. If you are using a modern distribution (beyond Ubuntu 24), you will likely want to use JoyDX release for webkit4.1
Podman
In the case of running on Linux, if you are intending to run Podman managed by JoyDX, it will be necessary to install a couple of qemu support libraries to work with the podman container daemon. For the various distributions
| Distribution | Packages to Install |
|---|---|
| Ubuntu 24.04 | qemu-utils qemu-system-x86 |
If instructions for your setup have are not included above, please get in contact
Upgrading
JoyDX publishes artefacts on Github within the joy-dx/joydx-releases repository.
Once installed, JoyDX will intermittently check for new versions using the current version endpoint, inform you about available updates, and has a built-in self-update mechanism.