Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

marina manages docker instances

Project Description


Marina is a tool for building docker images with a focus on separating compile-time dependencies from run-time dependencies in order to keep the shipped images small and secure.


pip install marina


marina -vvv build examples/shootout

App Config

name: dummy

  base_image: ubuntu:14.04
    - dd if=/dev/urandom of=/srv/dummy bs=50kB count=1
    - /srv/dummy

  base_image: ubuntu:14.04

Running Tests

pip install marina[testing]

0.3.0 (2017-03-10)

  • Update to use docker package instead of the now-defunct docker-py package.

0.2.0 (2016-10-11)

  • Pin to docker-py < 1.10 until a bug is fixed. See
  • [build] The cache volume is now created as a docker volume instead of a data container. It can be controlled using docker volume commands.
  • [build] Properly exit with an error if there was an issue reading from the container stdout/stderr while attached.
  • [build] The busybox image is no longer required. The archive will be pulled directly from the build container.

0.1.1 (2016-10-07)

  • [build] Fix an issue when the system does not already have the busybox image installed.

0.1.0 (2016-09-14)

  • [build] Fix some unicode issues when running on Python 2.

0.0.9 (2016-07-25)

0.0.8 (2016-07-22)

  • Support Python 3.
  • [build] Stop using an API that was removed in docker 1.12.
  • [build] Allow the BUILD_CONTEXT (cwd in scripts) to be writeable. Previously it was mounted readonly.
  • [build] Search for the ssh identity file in known paths.
  • [build] Add a workaround for a bug in docker-py causing the runner image to fail to build. See

0.0.7 (2016-02-18)

  • [build] Flush stdout to keep container messages from pausing.

0.0.6 (2016-01-08)

  • [build] Delete any volumes associated with a container.
  • [build] Fix usage of ExposedPorts from runner base image.

0.0.5 (2015-08-25)

  • [build] Exit with an error code upon failure instead of 0.

0.0.4 (2015-08-24)

  • Turn off docker hostname verification to enable connections with docker-machine instances over SSL until is resolved.
  • [build] Avoid detaching from the archive container before the tarfile has been fully written to disk.
  • [build] Add --skip-cleanup option for keeping images/containers/files around after the build.

0.0.3 (2014-11-19)

  • Support docker 1.3.x and its TLS requirements.

0.0.2 (2014-07-12)

  • Support --quiet for suppressing output.
  • [build] Add --env option for specifying credentials and other configurable build-time settings.
  • [build] Ensure the busybox image is around.

0.0.1 (2014-07-03)

  • Initial release.
  • First cut at “marina build” to generate a working docker container.

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(14.2 kB) Copy SHA256 Hash SHA256
Wheel py2.py3 Mar 10, 2017
(12.6 kB) Copy SHA256 Hash SHA256
Source None Mar 10, 2017

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting