Skip to content


Subversion checkout URL

You can clone with
Download ZIP
The complete Buddycloud stack in a VM
SaltStack Scheme Shell
Branch: master
Failed to load latest commit information.
saltstack Patience....
.gitignore remove saltstack/config/minion.d/ Update
Vagrantfile Get rid of


The VM can be run locally and also used as a way to setup Buddycloud on deployed into a cloud provider (e.g. AWS and Google-Cloud).


Quick: The buddycloud-vm project is designed to give developers a complete Buddycloud stack in about 10 mintues.

Ship identical bits to dev and production: The Buddycloud-VM and the BC saltstack project help you ship the same configuration to your developer environment as you ship to your production environment. Both environments use identical orchestration files and help you reduce the "but it worked in dev" type scenarios.

How it works

  1. Vagrant to build a VM
  2. Install a definied list of components.
  3. Configure each package.

Using the VM

The VM is designed to expose buddycloud-services out to your workstation. A quick ascii-art diagram explaines.

 |                                                 |
 |   Local workstation                             | 
 |   -----------------                             | 
 |   * set local DNS to use              | 
 |   * port forwards 53,5222,8080 -> buddycloud-vm | 
 |   *                  |
 |                                                 | 
             |          |             |
         (port 53)  (port 5222)  (port 8080)
             |          |             |
 |                                                 |
 |   buddycloud-VM                                 |
 |   -------------                                 |
 |   * hostname:                    |
 |   * listening for DNS queries on port 53        |
 |   * answers * with     |
 |   * forwards  other queries to          |
 |   * runs complete buddycloud stack              |
 |   * TLS functions disabled                      |
 |   * federation disabled                         |
 |                                                 |

Run the Buddycloud VM

Install Git Install VirtualBox Install Vagrant (v1.7.2 or later)

Open a terminal

git clone
cd buddycloud-vm
vagrant up

This build process will take anywhere from 1 to 10 minutes depending on the speed of your network and disk. The log of the build is stored inside the VM (see below for accessing) /var/log/salt/minion.

Access Buddycloud services running on the VM

  1. set your workstation DNS server to use
  2. browse to

SSHing into the VM

vagrant ssh

# or, 
ssh-keygen -R '[localhost]:2222' # remove old key
ssh vagrant@localhost -p2222     # password is `vagrant`

(for convenience, add your username and public key to saltstack/salt_local/pillar/users/init.sls)

Edit VM configuration (e.g. domainname, ssh keys, buddycloud config)

Outside the VM Inside the VM
Public configs buddycloud-vm/saltstack/salt_local/salt/* /srv/salt_local/salt
Private configs buddycloud-vm/saltstack/salt_local/pillar/* /srv/salt_local/pillar

[Re]configure the VM

salt "*" state.highstate -l all

Adding your own changes


Inside the VM:

sudo git clone /srv/my-buddycloudstack

Edit /etc/salt/master to include the second file_roots: like this:

    - /srv/salt_local/salt
    - /srv/my-buddycloudstack/salt

Edit your configuration in /srv/my-buddycloudstack/salt and update /srv/salt_local/salt/top.sls where necessary.

You now have a configuration:

  1. /srv/salt_local/salt is checked first (e.g. salt formula for buddycloud-server-java)
  2. /srv/my-buddycloud-stack/salt is checked second,
  3. finally, is checked.

Activate your changes:

salt "*" state.highstate -l all

(and don't forget to commit /srv/my-buddycloudstack back to git before you destroy your VM)

Shutting down the VM

Shut down Vagrant with: vagrant halt. Running vagrant kill will remove all disks and configs.

Depoloying Buddycloud to different providers

To deploy to a hosting provider, edit the Vagrantfile with your cloud-hosting-provider data.

Google Cloud

Configure according to, then:

vagrant plugin install vagrant-google
vagrant up --provider=google


vagrant plugin install vagrant-vsphere
vagrant up --provider=vsphere

Running in Production

It's recommended to configure to:

Something went wrong with that request. Please try again.