endurasolution/flashlin repository overview

flashlin/
├── src/                      # Rust source
│   ├── main.rs                 # Entry point, config loading, banner
│   ├── server/                  # TCP listener, worker pool, graceful shutdown
│   ├── http/                    # Request parsing, response helpers, router
│   ├── config/                  # TOML parser + validator
│   ├── cache/                   # In-memory response cache (DashMap + TTL)
│   ├── static_files/            # File serving, ETag, cache headers, path security
│   ├── php/                     # PHP-FPM + FastCGI protocol implementation
│   ├── proxy/                   # Reverse proxy + upstream management
│   ├── tls/                     # rustls config + certificate loader
│   ├── security/                # Rate limiter, IP ACL, security headers
│   ├── middleware/               # Compression, request-ID, access logging
│   ├── metrics/                  # Prometheus counters + exposition
│   └── tests/                     # Integration tests
├── server.toml                # Full configuration reference
├── domains/                   # Example virtual host configs
├── examples/                  # Example configs (HTTP/3, ACME, performance, …)
├── docs/                      # HTTP_PROTOCOLS.md, PRODUCTION.md, PERFORMANCE.md, …
├── production/                # Self-contained per-distro deploy packages
│   ├── centos/  debian/  raspberry-pi/  universal/
│   └── install.sh, install_linux_cdn.sh, systemd unit, …
├── dockerflashlin/            # ← you are here — Docker & Compose setup
│   ├── Dockerfile, Dockerfile.prebuilt
│   ├── docker-compose*.yml
│   ├── config/, certs/, public/
│   └── README.md (this file)
└── .github/workflows/         # CI — tests, and build + publish this Docker image

docker pull endurasolution/flashlin:2.0.0

dockerflashlin/
├── Dockerfile                  # Multi-stage build from source (default)
├── Dockerfile.prebuilt         # Installs the released binary via install_linux.sh
├── docker-compose.yml          # HTTP on port 80
├── docker-compose.tls.yml      # HTTPS on 443 + HTTP 80→443 redirect
├── docker-compose.php.yml      # PHP-FPM + HTTP port 80
├── docker-compose.php.tls.yml  # PHP-FPM + HTTPS port 443
├── entrypoint.sh
├── config/
│   ├── server.toml             # HTTP, port 80
│   ├── server.tls.toml         # HTTPS, port 443
│   ├── server.php.toml         # PHP-FPM + HTTP
│   └── server.php.tls.toml     # PHP-FPM + HTTPS
├── certs/                      # Mount your TLS certs here
└── public/
    ├── index.html               # Example static page
    └── index.php                # Example PHP page

docker run -d --name flashlin -p 80:80 endurasolution/flashlin:2.0.0

docker logs -f flashlin      # tail logs
docker stop flashlin         # stop
docker rm flashlin           # remove

cd dockerflashlin
docker compose up -d              # HTTP, port 80
docker compose logs -f flashlin
docker compose down

services:
  flashlin:
    image: endurasolution/flashlin:2.0.0
    container_name: flashlin
    restart: unless-stopped
    ports:
      - "80:80"
    volumes:
      - ./public:/var/www/html:ro
      - ./config/server.toml:/etc/flashlin/server.toml:ro
      - flashlin_logs:/var/log/flashlin
    environment:
      RUST_LOG: info
      FLASHLIN_CONFIG: /etc/flashlin/server.toml

volumes:
  flashlin_logs:

dockerflashlin/certs/
├── fullchain.pem    # certificate + intermediate chain
└── privkey.pem      # private key

# On the host:
certbot certonly --standalone -d yourdomain.com

mkdir -p certs
cp /etc/letsencrypt/live/yourdomain.com/fullchain.pem certs/
cp /etc/letsencrypt/live/yourdomain.com/privkey.pem   certs/

mkdir -p certs
openssl req -x509 -newkey rsa:4096 -sha256 -days 365 -nodes \
  -keyout certs/privkey.pem \
  -out    certs/fullchain.pem \
  -subj   "/CN=localhost"

docker compose -f docker-compose.tls.yml up -d

certbot renew
cp /etc/letsencrypt/live/yourdomain.com/fullchain.pem certs/
cp /etc/letsencrypt/live/yourdomain.com/privkey.pem   certs/
docker compose -f docker-compose.tls.yml restart flashlin

[http3]
enabled = true
port = 443
max_concurrent_streams = 32

# From the project root:
docker build -f dockerflashlin/Dockerfile -t flashlin .

# Or let Compose handle it:
cd dockerflashlin && docker compose build

cd dockerflashlin
docker build -f Dockerfile.prebuilt -t flashlin .

WEBROOT=/srv/mysite docker compose -f docker-compose.tls.yml up -d

docker run -d \
  --name flashlin \
  -p 80:80 -p 443:443 \
  -v /path/to/server.toml:/etc/flashlin/server.toml:ro \
  -v /path/to/site:/var/www/html:ro \
  -v /path/to/certs:/etc/flashlin/certs:ro \
  endurasolution/flashlin:2.0.0

# docker-compose.php.tls.yml
  php-fpm:
    build:
      context: .
      dockerfile_inline: |
        FROM php:8.2-fpm-alpine
        RUN docker-php-ext-install pdo pdo_mysql

docker compose -f docker-compose.php.yml build
docker compose -f docker-compose.php.yml up -d

# Logs
docker compose logs -f flashlin

# Restart (picks up new certs or a changed config)
docker compose -f docker-compose.tls.yml restart flashlin

# Shell inside the container
docker compose exec flashlin sh

# Clear the running server's in-memory response cache
# (loopback-only — must run inside the container's network namespace)
docker exec flashlin flashlin purge cache

# Check config without starting a listener
docker exec flashlin flashlin --check /etc/flashlin/server.toml

# Stop everything
docker compose down

# Stop and remove volumes too
docker compose down -v

# Update to a newer image
docker pull endurasolution/flashlin:2.0.0
docker compose down && docker compose up -d