Skip to content

Getting Started

There are multiple ways to install or setup you Infrared instance. Depending on what setup you choose you will have different pro and cons in usage and update cycles.

Quick Start

One of the quickest ways to get started is by just downloading the latest release of Infrared from GitHub for your machine and executing it.

Find the binary for your system

Most common ones are in bold.

HardwareOSfor 32-bitfor 64-bit
PC, VPS or Root ServerLinux basedLinux_i386*Linux_x86_64
Raspberry PiRaspberry Pi OSLinux_armv6*Linux_arm64
Custom/Prebuild PCWindowsWindows_i386*Windows_x86_64
Intel Mac or MacBookmacOS-Darwin_x86_64
M1 or higher Mac or MacBookmacOS-Darwin_arm64

*These architectures are most of the time the correct, but there is more to it.


If your system as a desktop environment then you should be able to download your binary by just clicking on the version you want on the releases page. The URL of your download should look something like this:{version}/infrared_{architecture}.tar.gz

For example:


If you are using SSH to connect to a remote server and are currently using a desktop environment with a browser you can just right-click the version you need and copy the link. Then paste it into your terminal with Ctrl+Shift+V on GNU/Linux or right-click on Windows.

Downloading by using the terminal on macOS or GNU/Linux:

curl -LO{version}/infrared_{architecture}.tar.gz

Downloading by using Powershell on Windows:

Invoke-WebRequest -Uri -OutFile c:\

Extracting the binary

Extracting by using the terminal on macOS or GNU/Linux:

tar -xzf infrared_{architecture}.tar.gz

Extracting by using Powershell on Windows:

Expand-Archive c:\ -DestinationPath c:\


Official Image on Docker Hub
Github Registry

Docker Compose

version: "3.8"

    image: haveachin/infrared:latest
    container_name: infrared
    restart: always
      - 25565:25565/tcp
      - ./data/infrared:/etc/infrared

Released under the AGPL-3.0.