reploy

Reploy

Reploy is an experimental deployment lifecycle tool for services.

Reploy turns an environment blueprint into a local staging workspace, lets you configure and test it, then installs its optional workload. Docker is the first supported runtime.

Generated builds select their builder from the chosen local engine. Docker uses BuildKit. For experiments with a local Linux Podman Docker-compatible socket, Reploy selects the compatible build API and checks local-image access, offline RUN, read-only mounts and result loading before generated builds. Users do not need to set DOCKER_BUILDKIT.

When Podman's compatible inspection omits healthcheck metadata, Reploy reads its image export through the same local endpoint and verifies the actual config against the immutable image ID. Absent metadata is never treated as disabled. Verified metadata is reused only within the current invocation.

This fallback streams the full image archive without extracting it. Client limits are 64 GiB, five minutes, 4 MiB for config JSON, 1 MiB for the manifest, and 10,000 archive entries. Podman first creates a full server-side temporary archive; client limits do not bound that disk cost. Large images can therefore make the first metadata check expensive. Docker uses normal inspection.

For Podman, Reploy prepares newly created containers through the same local engine's native update API before initialization/start, so disabled image healthchecks cannot create timers. Image metadata and validation stay intact. Compose startup prepares each new container, including replacements. An old container with a disabled check and a positive timer interval is removed before recreation, while Podman can still clean up its existing timer. No global timer setting or separately installed Podman CLI is required.

This is a temporary compatibility path for disabled-check scheduling. Full Podman compatibility remains unqualified.

Install

Install the latest release binary:

curl -fsSL https://reploy.cli.dev/install.sh | sh

On Windows, use the PowerShell installer:

irm https://reploy.cli.dev/install.ps1 | iex

From cmd.exe, invoke PowerShell explicitly:

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://reploy.cli.dev/install.ps1 | iex"

See the installation docs for script options and other installation methods.

Quickstart

Try Reploy with the included OmegaConf Inspector demo:

OmegaConf Inspector is a small browser app for merging YAML config layers and inspecting the OmegaConf result. It is useful as a Reploy demo because it has real Python dependencies, service config, a browser UI, health checks, logs, control commands, and writable project data, but stays neutral enough to try without learning a domain-specific app first.

APP_REF=omegaconf-inspector-demo

# Create a self-contained staging workspace in ./reploy-staging.
reploy stage "$APP_REF"

# Resolve packages, build the image, and validate it.
reploy build

# Configure and operate the app through its staging-owned command.
./reploy-staging/appctl config init
./reploy-staging/appctl config check

# Start and test the staged service.
./reploy-staging/appctl up
reploy test

# Install the tested staging workspace for the current user.
reploy install --scope user --to "$PWD/omegaconf-inspector-installed"

# Tail logs through the installed app control script.
./omegaconf-inspector-installed/appctl logs --tail=100

Read the app installation guide for the full staging and install workflow.

Documentation

Read the Reploy documentation for the full guide.

Maintainer setup is documented in docs/MAINTAINING.md. Design notes live in docs/. The public controlled-session host and controller boundaries are documented in website/docs/controlled-sessions.md.