Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
103 lines (67 sloc) 4.24 KB

Cloud Pebble local installer / Vagrant machine

This repo contains how to manually install the key components of CloudPebble as submodules into a Vagrant Linux VM. It also contains a docker-compose file that will assemble all of them into something that runs like a real CloudPebble instance. A big thank you from me and the whole Pebble community to the awesome Katharine Berry - ( for making this possible.


  • Pebble SSO is not available; only local accounts work.
  • Websocket installs are not available because pebble SSO is not available


Automatic installation using Vagrant

WARNING: patience and a cup of coffee are needed :)

git clone && cd vagrant-cloudpebble-composed && vagrant up

How to use it

Simply access from your host machine via browser http://localhost

Manual installation

Install Ubuntu using Vagrant

NOTE: you do not need to clone the repo if you want to install manually

vagrant init ubuntu/xenial64
vagrant up
vagrant ssh

IMPORTANT: remember to add RAM to the VM, I've had success with 2GB but I didn't try other values, default value WILL NOT WORK

Remove Docker IF installed

sudo apt-get remove docker docker-engine -y

Install and test Docker

sudo apt-get update && sudo apt-get install apt-transport-https ca-certificates curl software-properties-common -y && curl -fsSL | sudo apt-key add - && sudo add-apt-repository "deb [arch=amd64] $(lsb_release -cs) stable" && sudo apt-get update && sudo apt-get install docker-ce -y && sudo docker run hello-world

If everything went fine you should see the Docker "Hello World" and you can proceed to the next step

Install docker-compose

sudo apt-get install docker-compose -y

Install node

sudo apt remove nodejs npm && curl -sL | sudo -E bash - && sudo apt-get install -y nodejs

Install CloudPebble

git clone && cd vagrant-cloudpebble-composed && git clone && git clone && git clone

Install PebbleJs

cd cloudpebble/ext && git clone cloudpebble/ext && cd ../../

Be sure that you are in vagrant-cloudpebble-composed dir and run

sudo chmod +x && sudo ./

If everything worked fine you can start CloudPebble

sudo docker-compose up

A few useful Docker commands

Stop all containers

docker stop $(docker ps -a -q)

Delete all containers

docker rm $(docker ps -a -q)

Delete all images

docker rmi $(docker images -q)

How to use

Point your web browser to http://localhost

Release History

  • 0.0.1
    • Vagrantfile is now included, manual steps are tested.
    • A bug prevents images to be cloned from github repo


Davide Nastri –

Distributed under the GPL license. See LICENSE for more information.


  1. Fork it (
  2. Create your feature branch (git checkout -b feature/fooBar)
  3. Commit your changes (git commit -am 'Add some fooBar')
  4. Push to the branch (git push origin feature/fooBar)
  5. Create a new Pull Request