install labelpipe Free

1. install Docker

   Docker Engine with Compose 2.34 or newer on Linux, or Docker Desktop on macOS and Windows. Get Docker

2. run the install command

   In a terminal, in an empty folder:

   TerminalCopy

   $ docker compose -f oci://ghcr.io/plamenbv/labelpipe-compose:latest up -d

   Docker may ask you to confirm that you trust a compose file from the internet, ending with Do you want to continue? [y/N]. Type y and press Enter.

   labelpipe creates its own keys and database passwords on the first start. It listens on port 8080 of this machine only: put Caddy or another web server in front of it for HTTPS. Optional settings, such as the address and port, go in a .env file in the same folder.

   Older Docker Compose (before 2.34) says unknown scheme or cannot read oci://. Download the compose file instead; this works with any Compose 2:

   Older Docker ComposeCopy

   $ curl -fsSLO https://www.labelpipe.app/compose.yaml
   $ docker compose up -d

   With the downloaded file, update with docker compose pull && docker compose up -d, and stay on one version with LABELPIPE_VERSION=1.0.0 in .env.

3. open the setup link

   The first start prints a one-time setup link. Show it with:

   TerminalCopy

   $ docker compose -f oci://ghcr.io/plamenbv/labelpipe-compose:latest logs web | grep "first-run setup"

   If you used the downloaded compose file, docker compose logs web | grep "first-run setup" is enough.

   Open the newest link, create the first administrator and set up the authenticator app. Save the recovery codes it shows. The link works for 24 hours, and a new one appears at every restart until an administrator exists.

Updating later: run the install command again. To stay on one version, use a version tag such as :1.0.0 instead of :latest in the install command. Templates, jobs and settings are kept in Docker volumes.