cloudron-minibase

A minimal Docker base image for packaging apps on Cloudron.

cloudron/base is the standard choice for Cloudron apps, but it ships a large stack of runtimes and tools that many apps never use. cloudron-minibase keeps only the pieces Cloudron apps consistently need, and leaves language runtimes, web servers, and database clients to each app Dockerfile.

Included

cloudron-minibase includes:

• bash for Cloudron's web terminal and common start.sh scripts
• gosu for root -> cloudron privilege dropping
• ca-certificates, locales, and tzdata
• curl, wget, tar, gzip, unzip, jq, rsync
• sed, awk, grep, find, and standard GNU utilities
• less, nano, procps, iproute2, net-tools, ping, and sudo
• a cloudron user at uid:gid 1000:1000
• /app/code and /app/data
• en_US.UTF-8

Not Included

You install your app-specific stack yourself:

• Python
• Node.js
• PHP
• Ruby
• Go
• Java
• nginx
• Apache
• database CLI clients
• supervisor

See docs/cheat-sheet.md for common install recipes.

Usage

Use it as your base image, then install only the runtime you need:

ARG BASE_IMAGE=tcmbp132021/cloudron-minibase:0.0.1@sha256:a9c29ddb555b1a33f1e5b3b70c512e3a799cc691770d5016c70e0195e74764e0

FROM ${BASE_IMAGE}

RUN apt-get update && apt-get install -y --no-install-recommends \
        python3 \
        python3-pip \
    && rm -rf /var/lib/apt/lists/*

WORKDIR /app/code
COPY . .
COPY start.sh /app/code/start.sh
RUN chmod +x /app/code/start.sh

CMD ["/app/code/start.sh"]

For local testing before publishing, the test app in test/ defaults to the local tag cloudron-minibase:0.0.1.

Cloudron Compatibility

Cloudron platform features still come from the platform, not the base image:

• TLS and reverse proxying
• backups of /app/data
• app health checks
• addon credentials via environment variables
• web terminal and file manager support
• automatic restarts

Image Details

• Base OS: ubuntu:24.04
• Version: 0.0.1
• Target size: roughly 120MB, with acceptance under 200MB
• Default WORKDIR: /app/code

Build

The helper scripts default to linux/amd64, which is what you usually want when building on Apple Silicon for a Cloudron server.

Build locally:

./build.sh <image-repo> <version> [platform]

Examples:

./build.sh tcmbp132021/cloudron-minibase 0.0.1
./build.sh tcmbp132021/cloudron-minibase 0.0.1 linux/arm64

Publish to Docker Hub:

./publish.sh <image-repo> <version> [platform]