Skip to content
Projects

CrafterKolyan/tiny-python-docker-image

View on GitHub

CrafterKolyan/tiny-python-docker-image has 75 GitHub stars and 7 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-17 19:09 UTC. Last push 2026-11-12.

How these counts are measured

Measured star growth

in 24h
0
in 7 days
Collecting history
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

The most lightweight python docker image possible

Developer Tools

README.md

Original

Tiny Python Docker image

The most lightweight Python 3 Docker image possible.

.. image:: https://github.com/CrafterKolyan/tiny-python-docker-image/actions/workflows/update-repository.yml/badge.svg?branch=main :target: https://github.com/CrafterKolyan/tiny-python-docker-image/actions/workflows/update-repository.yml

Possible variants

.. csv-table:: :header: Dockerfile,Description,Size,Version :widths: 10, 70, 10, 10

Dockerfile.scratch-minimal,Minimal Python image with almost no libraries from scratch,2.691 MB,3.14.10
Dockerfile.scratch-full,Smallest Python image with default libraries from scratch,10.54 MB,3.14.10
Dockerfile.haizaar-minimal,Stripped official Python image (`haizaar/python-minimal`_),14.69 MB,3.15.2
Dockerfile.python-alpine,Python Alpine-based Official,19.68 MB,3.15.2
Dockerfile.alpine,Alpine-based,20 MB,3.14.10
Dockerfile.python-slim,Minimal packages needed to run python,44.31 MB,3.15.2
Dockerfile.ubuntu,Ubuntu-based,56.98 MB,3.14.4
Dockerfile.python,Python Debian-based Official with a lot of packages,419 MB,3.15.2

Requirements

  • Docker

Usage

Building image

.. code-block:: bash

    docker build -t python-tiny . -f <Dockerfile name>

For example:

.. code-block:: bash

    docker build -t python-tiny . -f Dockerfile.scratch-full

Running image
`````````````
.. code-block:: bash

  docker run --rm -it python-tiny

Technologies
------------
- Docker
- :code:`ldd` (prints the shared libraries required by each program or shared library specified on the command line): used to create :code:`scratch-full` and :code:`scratch-minimal` images.

Related links
-------------
- https://xebia.com/blog/how-to-create-the-smallest-possible-docker-container-of-any-image/
- https://xebia.com/blog/create-the-smallest-possible-docker-container/

Related projects
----------------
- https://github.com/jfloff/alpine-python
- https://github.com/haizaar/docker-python-minimal

.. _haizaar/python-minimal: https://github.com/haizaar/docker-python-minimal