---
title: "Development builds"
description: "Development builds are container images built from every push to main and tagged with the commit, for testing only and never for production."
---

:::warning

Development builds are created automatically from the latest `main` branch
and are **not versioned releases**. They may contain incomplete features,
breaking changes, or bugs. Use them for testing only.
:::

Each push to `main` produces container images and cross-compiled binaries.
Container images are multi-arch (amd64, arm64) and use the same distroless
base image as official releases.

## Container images

Images are on the GitHub Container Registry, tagged with the short commit hash
of the build (e.g. `main-abc1234`): `ghcr.io/aislopware/slopscale:main-<sha>`

To find the latest available tag, check the
[GitHub Actions workflow](https://github.com/aislopware/slopscale/actions/workflows/container-main.yml)
or the [GitHub Container Registry package page](https://github.com/aislopware/slopscale/pkgs/container/slopscale).

For example, to run a specific development build:

```shell
docker run \
  --name slopscale \
  --detach \
  --read-only \
  --tmpfs /var/run/slopscale \
  --tmpfs /tmp \
  --volume "$(pwd)/config:/etc/slopscale:ro" \
  --volume "$(pwd)/lib:/var/lib/slopscale" \
  --publish 127.0.0.1:8080:8080 \
  --publish 127.0.0.1:9090:9090 \
  --health-cmd "CMD slopscale health" \
  ghcr.io/aislopware/slopscale:main-<sha> \
  serve
```

See [Running slopscale in a container](/slopscale/setup/install/container) for full container setup instructions.

## Binaries

Binaries are published with each [release](https://github.com/aislopware/slopscale/releases) for Linux amd64, arm64
and armv7, statically linked so they run on any distribution. There are no macOS or FreeBSD binaries: [build from
source](/setup/install/source) or use the Nix flake there. The `main` branch is not built into binaries, only into
the container image above.

After downloading, make the binary executable and follow the
[standalone binary installation](/slopscale/setup/install/official#using-standalone-binaries-advanced)
instructions for setting up the service.