Update on PCF Dev
This is the depricated version of PCF Dev - please visit the current Github repository https://github.com/cloudfoundry-incubator/cfdev for the latest updates
PCF Dev is a new distribution of Cloud Foundry designed to run on a developer’s laptop or workstation. PCF Dev gives application developers the full Cloud Foundry experience in a lightweight, easy to install package. PCF Dev is intended for application developers who wish to develop and debug their application locally on a full-featured Cloud Foundry. PCF Dev is also an excellent getting started environment for developers interested in learning and exploring Cloud Foundry.
More information about the project can be found on the FAQ.
This repository contains source code that allows developers to build an open source version of PCF Dev that only contains the Elastic Runtime and the CF MySQL Broker. The binary distribution of PCF Dev that is available on the Pivotal Network contains other PCF components (such as the Redis, RabbitMQ and Spring Cloud Services marketplace services as well as Apps Manager) that are not available in this repository.
However, we encourage you to leave any feedback or issues you may encounter regarding the full, binary distribution of PCF Dev in this repository's Github issues.
- Download the latest
pcfdev-VERSION-PLATFORM.zipfrom the Pivotal Network.
- Unzip the zip file and navigate to its containing folder using PowerShell or a Unix terminal.
- Run the extracted binary.
cf dev start.
Check out the documentation for more information. Running
cf dev helpwill display an overview of PCF Dev VM management commands.
- CF CLI
- VirtualBox: 5.0+
- Internet connection (or Dnsmasq or Acrylic) required for wildcard DNS resolution
Using the Cloud Foundry CLI Plugin
Follow the instructions provided at the end of
cf dev start to connect to PCF Dev:
Downloading VM... Progress: |====================>| 100% VM downloaded Importing VM... Starting VM... Provisioning VM... Waiting for services to start... 40 out of 40 running _______ _______ _______ ______ _______ __ __ | || || | | | | || | | | | _ || || ___| | _ || ___|| |_| | | |_| || || |___ | | | || |___ | | | ___|| _|| ___| | |_| || ___|| | | | | |_ | | | || |___ | | |___| |_______||___| |______| |_______| |___| is now running. To begin using PCF Dev, please run: cf login -a https://api.local.pcfdev.io --skip-ssl-validation Admin user => Email: admin / Password: admin Regular user => Email: user / Password: pass
local.pcfdev.iodomain may differ slightly for your PCF Dev instance.
To stage a simple app on PCF Dev,
cd into the app directory and run
cf push <APP_NAME>.
Using a customized PCF Dev OVA
Specify the path to the custom built OVA with the
-o flag to the
cf dev start command.
$ cf dev start -o /path/to/custom/ova Importing VM... Starting VM... Provisioning VM.. ...
To build a custom PCF Dev OVA, please see our DEVELOP Documentation.
To temporarily stop PCF Dev run
cf dev stop.
To destroy your PCF Dev VM run
cf dev destroy.
To uninstall the PCF Dev cf CLI plugin run
cf uninstall-plugin pcfdev
PCF Dev uses a version of Monit that can be found here, under the GPLv3 license.