Installation

Pick the install path that suits your platform. All methods produce the same redmine binary.

Install

Homebrew

For macOS and Linux. Ships shell completions for bash, zsh, and fish.

brew tap aarondpn/tap
brew install redmine

Install script

Auto-detects OS and architecture, verifies the SHA256 checksum, installs to ~/.local/bin.

curl -fsSL https://raw.githubusercontent.com/aarondpn/redmine-cli/main/install.sh | bash

PATH

Make sure ~/.local/bin is on your PATH. Most modern shells add it automatically.

go install

Builds from source via the Go toolchain. Requires Go 1.22+.

go install github.com/aarondpn/redmine-cli/v2/cmd/redmine@latest

Manual

Grab a prebuilt release for your platform.

Platform	Architecture	Asset
Linux	x86_64	redmine-linux-amd64.tar.gz
Linux	ARM64	redmine-linux-arm64.tar.gz
macOS	Intel	redmine-darwin-amd64.tar.gz
macOS	Apple Silicon	redmine-darwin-arm64.tar.gz
Windows	x86_64	redmine-windows-amd64.zip

Downloads live on GitHub Releases.

Verify

1. Confirm the binary is resolvable and prints its version:

   redmine --version

2. Run the built-in health check to smoke-test the install:

   redmine --help

3. Continue to Configuration to wire up your Redmine server.

Update

self-update

redmine update

Pulls the latest release, verifies its SHA256 checksum, then replaces the running binary. See Self-Update for flags.

Checksum verification

The installer and self-updater both fail closed if the release checksum does not match. Never bypass this — report any mismatch as a security issue.

Next

Configure Set up your server, auth profile, and defaults.

Quick Start Issues, time tracking, and search in 5 minutes.