scratch-server 1.0.1

Simple HTTP Server
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

# Multi-stage build for minimal image size
FROM rust:alpine3.23 AS builder

# Install build dependencies
RUN apk add --no-cache perl make

# Create a new empty project
WORKDIR /app

# Copy manifests
COPY Cargo.toml Cargo.lock* ./
COPY build.rs ./

# Copy source code
COPY src ./src

# Build for release with static linking
RUN cargo build --release

# Runtime stage
FROM alpine:3.23.3

# Create a non-root user
RUN addgroup -g 1000 appuser && \
    adduser -D -u 1000 -G appuser appuser

# Create directory for serving files and custom index
RUN mkdir -p /srv /index && chown appuser:appuser /srv /index

WORKDIR /srv

# Copy the binary from builder
COPY --from=builder /app/target/release/scratch-server /usr/local/bin/scratch-server

# Switch to non-root user
USER appuser

# Environment variables (defaults)
ENV THREADS=12 \
    SILENT=false \
    CORS=false \
    COMPRESSION=false

# Expose the default port
EXPOSE 7878

# Entry point script that converts env vars to CLI args
ENTRYPOINT ["/bin/sh", "-c", "\
    ARGS=\"--port 7878 --threads ${THREADS} --ip 0.0.0.0\"; \
    [ \"${SILENT}\" = \"true\" ] && ARGS=\"${ARGS} --silent\"; \
    [ \"${CORS}\" = \"true\" ] && ARGS=\"${ARGS} --cors\"; \
    [ \"${COMPRESSION}\" = \"true\" ] && ARGS=\"${ARGS} --compression\"; \
    [ -n \"${AUTH}\" ] && ARGS=\"${ARGS} --auth ${AUTH}\"; \
    [ -n \"${CERT}\" ] && ARGS=\"${ARGS} --cert /certs/${CERT}\"; \
    [ -n \"${CERT_PASS}\" ] && ARGS=\"${ARGS} --certpass ${CERT_PASS}\"; \
    [ -f /index/index.html ] && ARGS=\"${ARGS} --index /index/index.html\"; \
    exec scratch-server ${ARGS}"]