Getting Started

Peer Installation With Vagrant (Advanced Installations)

The easiest and quickest way to get a Subutai Peer running on any platform is to use Vagrant with VirtualBox. Don't use package managers to install them: their versions are too old. Download the latest Vagrant 2.0.1 or higher and VirtualBox 5.1.0 or higher from their respective websites. Once Vagrant and VirtualBox are installed init the Vagrantfile then up the instance like so:

1.1 This command creates a Subutai Peer VM based on Debian 9.x. (Recommended):

                                vagrant init --minimal subutai/stretch

1.2 This command creates a Subutai Peer VM based on Ubuntu Server 16.04.3. :

                                vagrant init --minimal subutai/xenial

2. For Vagrant you will need to install the subutai and vbguest plugins:

                                vagrant plugin install vagrant-subutai
                                vagrant plugin install vagrant-vbguest

3. Once plugin is installed, you can create and start the Subutai Peer VM:

                                vagrant up

During this process you will be asked for which bridge interface you want to use. The first option provided by Vagrant is usually the right one: the network interface that is actively being used to get on the Internet.

After a lot of output you’ll see output similar (your console’s IP address might be different) to the following:

                                                default: SUCCESS: Your peer is up. Welcome to the Horde!
                                                default: -----------------------------------------------
                                                default: Next steps ...
                                                default: Make sure Subutai's E2E Extension/Plugin is installed in your browser
                                                default: Search for 'Subutai' in your browser's extension/plugin store to find it and install.
                                                default: Console URL:
                                                default: Default u/p: 'admin' / 'secret'
                                                default: Vagrant ssh and change the default 'subutai'/'ubuntai' user password!
                                                default: If you forget the url, just take a look in .vagrant/generated.yml

After your peer is created, you can log into it’s management console. From the output above you can see the IP based URL of your console.

                                                default: Console URL:

Before you log in to the peer console follow the Post Installation directions on installing the browser plugin and generating a PGP key first. Then just navigate to this Console URL (NOTE: the IP will most be different for your VM) using a web browser. Although we support many browsers, Chrome always behaves better than others. The console’s default admin password is secret. You will be asked to change it after initially being logged in. Once you reset your admin password, you will gain entry into the management console UI where you can change many aspects of the peer.

The first thing many users do is register it with the Subutai Bazaar to easily start sharing resources with friends and family. To register your peer find the “Register” button in the upper right hand corner of the UI. When you click this button, a dialog will pop up with fields asking you for your Subutai Bazaar login and password. Provide your Bazaar credentials and push the button. Within 3-10 seconds you should be notified of being logged in. The button’s color will change from gray to green . Your new peer will now appear on the Subutai Bazaar in your peers list.

Congratulations! You are ready to share resource with your new Subutai Peer on the Bazaar!

Post Installation

Install the client software and tools to use your peers and environments effectively. You're going to want to install the browser extension to manage pgp keys, the p2p client, and the OS control-center (wallet) application.

Before logging into the Peer Console, install the Subutai E2E Browser Extension for Chrome. It will prompt you to generate a new PGP key after installing. See the video below if installation is not obvious.

Download Subutai

For Developers

Subutai P2P x64 6.x
Subutai P2P x64 Dev
Subutai P2P x64 Master
Subutai Control Center x64 6.x
Subutai Control Center x64 Dev
Subutai Control Center x64 Master

Install the Subutai P2P

The P2P daemon allows systems to join the swarm to access private cloud environments. Install the MSI package for Windows. Double click after downloading.

Install the Subutai Control Center Application

Install the Control Center application to conveniently access environments from your desktop, manage your peers while showing you your Goodwill balance. Packages for Windows, Linux, and Mac OS are available.


We’d love to hear from you!