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

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 Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
marina-0.3.0-py2.py3-none-any.whl (14.2 kB) Copy SHA256 Checksum SHA256 py2.py3 Wheel Mar 10, 2017
marina-0.3.0.tar.gz (12.6 kB) Copy SHA256 Checksum SHA256 Source Mar 10, 2017

Supported By

WebFaction WebFaction Technical Writing 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 Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting