Napoleonic Political Magnificence


    1.8.1-hotfix-1 • Public • Published

    containership logo


    Build Status

    Build Status


    ContainerShip is an open source container management platform which aims to be the simplest way to run containers from dev to production. ContainerShip provides all the necessary pieces to your infrastructure including loadbalancing, service-discovery and DNS in a single package. Extending the core functionality is easy through the use of plugins. Find more detailed docs below!


    ContainerShip Developers -


    ContainerShip Demo

    Repository Structure

    This repository is a minimal wrapper around various other official ContainerShip repositories which comprise the full containership package:

    • codexd - filesystem snapshotting and replication built atop legiond
    • containership.api - containership leader API
    • containership.core - core containership functionality
    • containership.scheduler - default containership scheduler
    • legiond - secure distributed event layer for nodejs applications
    • myriad-kv - distributed key-value store built on top of praetor and legiond
    • praetor - leader election framework built atop LegionD
    • quarry - rock solid, dynamic DNS server with swappable backends and API


    The containership plugin system allows for the core of containership to be overridden by third party plugins. Below are a few official plugins created by ContainerShip:

    • cloud - connects cluster to SaaS ContainerShip Cloud product for easier management, cluster backups, etc
    • cloud-hints - automatically set cloud metadata in the form of host tags
    • firewall - firewall plugin for containership
    • logs - application log aggregator
    • navigator - web-ui for managing your containership clusters
    • service-discovery service discovery plugin for containership
    • tide - cron-like job scheduler

    Getting Started

    How do I install ContainerShip locally?

    npm install containership -g

    Can I spin up a cluster locally?

    Absolutely! First install Vagrant, then install our cloud plugin by running cs plugin add cloud. Once installed, run cs cloud create-cluster vagrant --leaders 1 --followers 2 to bring up a local cluster to play around with.

    This is pretty cool, how can I get a production cluster setup?

    ContainerShip will run on any linux host with node & docker (see our installation guide for more details). If you're using open source ContainerShip, use our official setting up your first cluster guide. If you'd like to manage your ContainerShip cluster using our ContainerShip Cloud management product, sign up for an account and follow the official getting started guide.

    How can I make modifications to ContainerShip locally?

    Read more about local development

    Support & Community


    Pull requests and issues are encouraged! Help us make ContainerShip even more awesome :)


    npm i containership

    DownloadsWeekly Downloads






    Last publish


    • containershipbot
    • normanjoyner