tandiljuan/laminar-server repository overview

⁠Laminar CI Container Images

This repository provides lightweight, ready-to-use container images for Laminar CI⁠, a fast, lightweight, and configuration-as-code continuous integration system.

The project is split into two specialized images to accommodate decentralized CI setups:

1. laminar-server⁠: Runs the core Laminar daemon (laminard) and hosts the web dashboard.
2. laminar-client⁠: Packages the Laminar CLI (laminarc) with webhookd⁠, allowing you to trigger CI jobs securely via HTTP webhooks.

Dockerfile: tandiljuan/docker-laminar on GitHub⁠

⁠Quick Start Guide

You can easily run both containers in a shared Docker network to test the webhook-to-job integration.

⁠1. Create a Network

docker network create laminar-net

⁠2. Run the Laminar Server

This container runs the core daemon. It exposes port 8080 for the web UI and port 9997 for RPC communication.

docker run --detach --rm \
    --name laminar-server \
    --hostname laminar-server \
    --network laminar-net \
    --env "LAMINAR_HOME=/var/lib/laminar" \
    --env "LAMINAR_TITLE=My Laminar CI" \
    --env "LAMINAR_BIND_HTTP=0.0.0.0:8080" \
    --env "LAMINAR_BIND_RPC=0.0.0.0:9997" \
    --publish "8080:8080" \
    tandiljuan/laminar-server

Access the web dashboard at http://localhost:8080.

⁠3. Run the Laminar Client (Webhook Gateway)

This container acts as a gateway, receiving webhooks and executing the Laminar CLI tool (laminarc) to trigger jobs on the server.

docker run --detach --rm \
    --name laminar-client \
    --hostname laminar-client \
    --network laminar-net \
    --env "WHD_LISTEN_ADDR=:8081" \
    --publish "8081:8081" \
    tandiljuan/laminar-client

⁠Configuration & Customization

To mount your own jobs, scripts, or configuration files, bind your host directories as volumes:

• Server Jobs configuration: Mount to /var/lib/laminar/cfg/jobs/
• Client Webhook scripts: Mount to /var/lib/webhook/

For detailed build instructions, advanced environment variables, and testing scripts, please visit the GitHub Repository⁠.