luan / cfkit

LinuxKit setup for running CloudFoundry locally without extra dependencies.

CFKit

Currently only runs on macOS.

Dependencies

To run CFKit you need:

• BOSH CLI installed as either bosh or gobosh in your PATH
• Moby - Available as a brew formula (linuxkit/linuxkit/moby) or via go get github.com/moby/tool/cmd/moby
• LinuxKit - Available as a brew formula (linuxkit/linuxkit/linuxkit) or via go get github.com/linuxkit/linuxkit/src/cmd/linuxkit
  • See their getting started
• HyperKit and VPNKit -- Not super easy to install standalone at the moment, maybe at some point there will be a brew package for them. At the moment having docker for mac installed will actually provide those dependencies to CFKit

Quick Start

There are 3 scripts available to get started quickly:

scripts/regenerate-creds # generate credentials / .envrc for talking to BOSH
scripts/run              # starts the linuxkit VM with BOSH in it, sets up networking
                         # be sure to look at /var/vcap/log/*.log in the tty to track progress of BOSH booting up
scripts/deploy           # deploys CF to the newly created BOSH

At this point your usual bosh-lite.com URL should be working to push apps to CF.