QR Code Generator

A minimal, distroless Docker container hosting a simple web UI for generating QR codes with SQLite persistence.

Features

• Generate QR codes from any text or URL
• History table with all generated QR codes
• Editable labels for organization
• Click to view/download full-size QR images
• Persistent storage via SQLite
• Tiny distroless container (~5MB)

Quick Start

# compose.yaml
services:
  qr-code-generator:
    image: ghcr.io/ironicbadger/qr-code-generator:latest
    ports:
      - "8080:8080"
    volumes:
      - qr-data:/data

volumes:
  qr-data:

# Using Docker Compose
docker compose up -d

# Or run directly
docker run -d -p 8080:8080 -v qr-data:/data ghcr.io/ironicbadger/qr-code-generator:latest

Access the web UI at http://localhost:8080

Development

Prerequisites

• Go 1.22+
• Docker

Local Development

# Run tests
go test -v ./...

# Build and run locally
go run ./cmd/server

# Build Docker image
docker build -t qr-code-generator .

Project Structure

qr-code-generator/
├── cmd/server/           # Application entrypoint
│   ├── main.go
│   └── templates/        # HTML templates (embedded)
├── internal/
│   ├── handler/          # HTTP handlers
│   ├── qrcode/           # QR generation
│   └── storage/          # SQLite storage
├── .github/workflows/    # CI/CD
├── Dockerfile            # Multi-stage distroless build
└── docker-compose.yml    # Local development

API Endpoints

Environment Variables

License

MIT