Quick Start

Get Aralez running in minutes — binary or Docker

Run it manually

Download the prebuilt binary for your architecture from the releases section of the GitHub repo. Make the binary executable and run it.

Available Binaries

File NameDescription
aralez-x86_64-musl.gzStatic Linux x86_64 binary, without any system dependency
aralez-x86_64-glibc.gzDynamic Linux x86_64 binary, with minimal system dependencies
aralez-aarch64-musl.gzStatic Linux ARM64 binary, without any system dependency
aralez-aarch64-glibc.gzDynamic Linux ARM64 binary, with minimal system dependencies
sadoyan/aralezDocker image on Debian 13 slim (Docker Hub)

Steps

  1. Download the latest release for your architecture from Releases:
wget https://github.com/sadoyan/aralez/releases/download/vX.Y.Z/aralez-xxx-yyy.tar.gz
tar -xzf aralez-xxx-yyy.tar.gz
  1. Make it executable:
chmod +x aralez-xxx-yyy
  1. Copy example configuration and adjust to your needs:
wget https://raw.githubusercontent.com/sadoyan/aralez/refs/heads/main/etc/main.yaml
wget https://raw.githubusercontent.com/sadoyan/aralez/refs/heads/main/etc/upstreams.yaml

  1. Edit to match your needs.

  2. Run it:

aralez-xxx-yyy -c main.yaml

Or via Docker

docker run -d \
  -v /local/path/to/config:/etc/aralez:ro \
  -p 80:80 \
  -p 443:443 \
  sadoyan/aralez