Installing PCF Dev on Mac OS X

Prerequisites

VirtualBox

PCF Dev uses VirtualBox version 5.0 and above as its virtualizer.

  1. Download the VirtualBox 5.0.14 .dmg file for Mac OS X hosts from VirtualBox.

  2. Open the .dmg file and double-click the VirtualBox.pkg icon.

  3. In the pop up that says “This package will run a program to determine if the software can be installed,” click Continue.

  4. In the installer wizard, click Continue.

  5. Select an install destination and click Install.

Cloud Foundry Command Line Interface

PCF Dev uses the Cloud Foundry Command Line Interface (cf CLI) to push and scale apps.

  1. To install the cf CLI for Mac OS X (64 bit), download it here. If you previously used the cf CLI v5 Ruby gem, uninstall this gem first.

  2. Open the .pkg file.

  3. In the installer wizard, click Continue.

  4. Select an install destination and click Continue.

  5. When prompted, click Install.

  6. To verify your installation, open a terminal window and enter cf. If your installation was successful, the cf CLI help listing appears.

Install PCF Dev

  1. Download the latest version of PCF Dev from the Pivotal Network.
  2. Unzip the downloaded zip file:
    $ unzip pcfdev-VERSION-osx.zip
  3. Install the PCF Dev plugin:
    $ ./pcfdev-VERSION-osx
  4. Start PCF Dev:

    $ cf dev start
    It may take several minutes for the PCF Dev virtual machine (VM) and its services to start.

    Note: You may be prompted to continue if your available memory is less than the recommended amount.

  5. If prompted, enter your API token. This token is required for authentication and appears at the bottom of the Edit Profile tab in your Pivotal Network account.

    Note: The API token does not appear in the terminal session when you enter it.

After the PCF Dev is now running banner appears, you can log in.

Stop PCF Dev

To temporarily stop PCF Dev, run the following command:

$ cf dev stop

Uninstall PCF Dev

To destroy the PCF Dev VM, run the following command:

$ cf dev destroy

To remove PCF Dev, run the following command:

$ cf uninstall-plugin pcfdev
Create a pull request or raise an issue on the source for this page in GitHub