• 2-5.3.0, 2-5.3, 2-5, 2 (2/Dockerfile)
• 2-5.3.0-slim, 2-5.3-slim, 2-5-slim, 2-slim (2/slim/Dockerfile)
• 2-5.3.0-onbuild, 2-5.3-onbuild, 2-5-onbuild, 2-onbuild (2/onbuild/Dockerfile)
• 3-5.2.0-alpha1, 3-5.2.0, 3-5.2, 3-5, 3, latest (3/Dockerfile)
• 3-5.2.0-alpha1-slim, 3-5.2.0-slim, 3-5.2-slim, 3-5-slim, 3-slim, slim (3/slim/Dockerfile)
• 3-5.2.0-alpha1-onbuild, 3-5.2.0-onbuild, 3-5.2-onbuild, 3-5-onbuild, 3-onbuild, onbuild (3/onbuild/Dockerfile)

For more information about this image and its history, please see the relevant manifest file (library/pypy). This image is updated via pull requests to the docker-library/official-images GitHub repo.

For detailed information about the virtual/transfer sizes and individual layers of each of the above supported tags, please see the pypy/tag-details.md file in the docker-library/docs GitHub repo.

PyPy is a Python interpreter and just-in-time compiler. PyPy focuses on speed, efficiency and compatibility with the original CPython interpreter.

PyPy started out as a Python interpreter written in the Python language itself. Current PyPy versions are translated from RPython to C code and compiled. The PyPy JIT (short for "Just In Time") compiler is capable of turning Python code into machine code at run time.

wikipedia.org/wiki/PyPy

FROM pypy:3-onbuild
CMD [ "pypy3", "./your-daemon-or-script.py" ]

or (if you need to use PyPy 2):

FROM pypy:2-onbuild
CMD [ "pypy", "./your-daemon-or-script.py" ]

These images include multiple ONBUILD triggers, which should be all you need to bootstrap most applications. The build will COPY a requirements.txt file,RUN pip install on said file, and then copy the current directory into/usr/src/app.

You can then build and run the Docker image:

$ docker build -t my-python-app .
$ docker run -it --rm --name my-running-app my-python-app

For many simple, single file projects, you may find it inconvenient to write a complete Dockerfile. In such cases, you can run a Python script by using the Python Docker image directly:

$ docker run -it --rm --name my-running-script -v "$PWD":/usr/src/myapp -w /usr/src/myapp pypy:3 pypy3 your-daemon-or-script.py

or (again, if you need to use Python 2):

$ docker run -it --rm --name my-running-script -v "$PWD":/usr/src/myapp -w /usr/src/myapp pypy:2 pypy your-daemon-or-script.py

View license information for software contained in this image.

This image is officially supported on Docker version 1.11.2.

Support for older versions (down to 1.6) is provided on a best-effort basis.

Please see the Docker installation documentation for details on how to upgrade your Docker daemon.

Documentation for this image is stored in the pypy/ directory of the docker-library/docs GitHub repo. Be sure to familiarize yourself with the repository's README.md file before attempting a pull request.

If you have any problems with or questions about this image, please contact us through a GitHub issue. If the issue is related to a CVE, please check for a cve-tracker issue on the official-images repository first.

You can also reach many of the official image maintainers via the #docker-library IRC channel on Freenode.

You are invited to contribute new features, fixes, or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can.

Before you start to code, we recommend discussing your plans through a GitHub issue, especially for more ambitious contributions. This gives other contributors a chance to point you in the right direction, give you feedback on your design, and help you find out if someone else is working on the same thing.