Try It Out

If you don't have a Python project to test out, you can use the following sample Python script that prints random facts about the Python programming language.

In your project directory, save the code below to a new file and name it python-script.py:

import random

# List of statements
statements = [
    "Python is The Beginner Friendly Language.",
    "Python Does Not Need a Compiler.",
    "Python Has One of the Largest Community Support.",
    "Python Is a Portable Language."
]

# Randomly shuffle the list and pick the first item
random.shuffle(statements)

# Print the first statement from the shuffled list
print(statements[0])

Run the script with the Minimus Python image:

docker run -it --rm \
    --name minimus-python-test \
    -v "$PWD":/usr/src/myapp \
    -w /usr/src/myapp \
    reg.mini.dev/python \
    python python-script.py

You should get a random fact about Python printed every time you run the script.

Create a project directory and save the code below to a new docker-compose.yml file:

services:
  flask-app:
    build: ./app
    ports:
      - "5000:5000"

Create a subdirectory and name it app. Add the following to it:

• Download the sample script main.py file (link).
• Save a requirements.txt file to list the Python packages that the project depends on. Python’s default package installer pip uses it. For our simple example, save only flask>=3.1.1 in the file.

In the same directory, save the code below to a new Dockerfile:

# === Build Stage ===

FROM reg.mini.dev/python:latest-dev as builder

WORKDIR /app

RUN python -m venv venv
ENV PATH="/app/venv/bin":$PATH
COPY requirements.txt requirements.txt
RUN pip install -r requirements.txt

# === Runtime Stage ===

FROM reg.mini.dev/python:latest

WORKDIR /app

COPY main.py main.py
COPY --from=builder /app/venv /app/venv
ENV PATH="/app/venv/bin:$PATH"

ENTRYPOINT ["python", "main.py"]

Your project directory should now look like this:

your-project-root/
├── docker-compose.yml
└── app/
    ├── Dockerfile
    ├── main.py
    └── requirements.txt

Next, build the app:

docker compose build

Docker Compose will build the app from the app folder. Once built you will see a confirmation ✔ flask-app Built.

Run the app:

docker compose up

Send a request to the app:

curl http://127.0.0.1:5000

You should get a response with the current date and time.

Once ready to clean up, run the following command to remove the container:

docker compose down

Technical Considerations

The Python image provided by Minimus is a slim, security-hardened alternative to the public image from Docker Hub. The images are largely interchangeable, with a few differences as noted below.

Terms & Info

This catalog is published by Minimus. All product names, logos, and marks, other than those belonging to Minimus, shown are owned by their respective rights holders and appear here only to identify the open source software each image contains. Minimus claims no ownership of those marks and implies no affiliation with, endorsement by, certification by, or sponsorship by any rights holder.

Images are provided "as-is" without warranty of any kind. "Hardened" refers to the security configuration applied at the time of build and does not constitute a guarantee of ongoing security or absence of vulnerabilities. The free tier is provided without support, SLA, or guaranteed patching timelines. Security updates may be applied to paid subscriptions before or instead of free tier images. By pulling or using any image you agree to our Terms of Use.