The Open-source self-hosted Platform-as-a-Service written in Go
Clone or download
Failed to load latest commit information.
build-packs New build-pack: Java Maven. Oct 9, 2014
env.example Partial progress on support for zfs-fuse, which is flaky about destro… Aug 29, 2013
extra-docs Documented sb-node reboot todo notes. Apr 4, 2014
install maxconn consistency in haproxy configuration and sysctl limits during… Oct 28, 2014
misc Install scripts cleaned up. Sep 23, 2014
pkg/appender Cleanup pass applying current-day best practices. (#23) Oct 6, 2017
src Updated HAProxy configuration template to allow even more vhosts. Feb 9, 2018
.gitignore Local builds now go to base directory instead of dist. Documentation … Aug 8, 2013 Troubleshooting formatting improvements. May 22, 2014
AUTHORS Initial import from old repo. Jul 22, 2013 NTP management automated via ShipBuilder cron. Oct 8, 2014 Cleanup for "create an app" documentation". Oct 2, 2014
EXAMPLE-aws_s3_iam_policy.json Pruned excessive permissions from example AWS S3 IAM json document. Apr 4, 2014
LICENSE Added license. Aug 8, 2013 Updated README link to Mar 11, 2018 Added details to pre-requisites documentation. Sep 30, 2014 update Deeper explanations. Apr 9, 2014 Removed build dependency hackery, replaced with `go get ./...'. (#24) Oct 6, 2017
deploy.go Merge pull request #18 from megahall/megahall/enable-core-dump Apr 3, 2017 Installer improvements: improved error checking in and inst… Jan 7, 2014


Additional information is available at


ShipBuilder is a git-based application deployment and serving system written in Go.

Primary components:

  • ShipBuilder command-line client
  • ShipBuilder server
  • Container management (LXC)
  • HTTP load balancer (HAProxy)

Build Packs

Any app server can run on ShipBuilder, but it will need a build-pack! The current build-packs are:

  • python - Any python app
  • nodejs - Node.js apps
  • scala-sbt - Scala SBT applications and projects
  • playframework2 - Play-framework 2.1.x


  • Ubuntu 13.10, 13.04, or 12.04 (tested and verified compatible)
  • go-lang v1.2 or v1.1
  • envdir (linux: apt-get install daemontools, os-x: brew install daemontools)
  • git and bzr clients
  • Amazon AWS credentials + an s3 bucket

Server Installation




Creating your first app

All applications need a Procfile. In ShipBuilder, these are 100% compatible with Heroku's Procfiles (documentation).


Getting Help

Have a question? Want some help? You can reach shipbuilder experts any of the following ways:

Discussion List: ShipBuilder Google Group IRC: #shipbuilder on FreeNode Twitter: ShipBuilderIO

Or open a GitHub issue.


  1. "Fork"
  2. Make a feature branch.
  3. Do your commits
  4. Send "pull request". This can be
    1. A github pull request
    2. A issue with a pointer to your publicly readable git repo
    3. An email to me with a pointer to your publicly readable git repo


Thank you to SendHub for supporting the initial development of this project.