// 001

Quick Install

One command to install Convex and add it to your PATH

macOS / Linux

curl -fsSL https://convex.world/install.sh | bash

Works on macOS, Linux, and Windows via WSL or Git Bash.

Windows PowerShell

irm https://convex.world/install.ps1 | iex

Run in PowerShell. Creates a convex command available system-wide.

Requires Java 21+. The installer checks and will tell you if Java is missing.

// 002

Direct Download

Download convex.jar and run it with java -jar

Development Snapshot

Latest build from the develop branch. May contain incomplete features or breaking changes.

Snapshot Build

All Releases

Browse all versions with changelogs. Pin to a specific version for production deployments.

GitHub Releases
// 003

Docker

Run a Convex peer in a container

1

Pull the image

docker pull convexlive/convex:latest
2

Run a peer

docker run convexlive/convex peer start

Available tags: latest (stable), snapshot (develop), or a specific version like 0.8.3. View on Docker Hub

// 004

Build from Source

Clone the repository and build with Maven

1

Clone the repository

git clone https://github.com/Convex-Dev/convex.git
2

Build

cd convex && mvn clean install

Requires Java 21+ and Maven 3.7+. The built JAR is at convex-integration/target/convex.jar