Delphin Bootstrap is a portable development environment for Delphin. It allows you to install, configure, and start a virtual machine that is ready to run Delphin - with a single command. This sandbox makes it very easy to learn about, test, and hack Delphin without messing with the configuration of your computer. It uses some cool technologies such as Vagrant, Puppet, and VirtualBox under the hood.
You need to have the following software already installed:
Note you should be able to use another virtual machine provider, but currently only VirtualBox is supported.
Make sure Vagrant is available from your terminal or console with:
$ vagrant version Installed Version: 1.8.1 Latest Version: 1.8.1
Installing Delphin is very easy - just load a terminal or console and:
- Clone the Delphin Bootstrap repository to your computer
- Go to your fresh new Delphin Bootstrap directory
vagrant upto bring the sandbox to life
On Linux, it will probably look like this:
$ git clone firstname.lastname@example.org:Automattic/delphin-bootstrap.git $ cd delphin-bootstrap $ vagrant up
On Windows, it's going to be very similar:
C:\>git clone email@example.com:Automattic/delphin-bootstrap.git C:\>cd delphin-bootstrap C:\delphin-bootstrap>vagrant up
Note this installation process can take quite some time the first time you perform a
vagrant up since it will basically:
- Download an image of the current stable version of Ubuntu
- Load it into the virtual machine and update it
- Install all necessary packages such as Git or Node.js
- Download the Delphin repository
Finally, just add
127.0.0.1 delphin.localhost to your
You should have a virtual machine up and running by now. The next step is simply to connect to this sandbox via SSH with your favorite terminal or console, either by typing
vagrant ssh, or using the following parameters:
- Host name:
- User name:
- User password:
These parameters should be pretty standard. However, if you encounter any issues connecting to the virtual machine, you can check them with the
Note your SSH client should be configured to allow SSH agent forwarding if you want to be able to use your local SSH keys to connect to GitHub from inside the virtual machine (using agents such as ssh-agent or Pageant).
You should then be presented with something similar to the following:
_ _ _ _ __| | ___| |_ __ | |__ (_)_ __ / _` |/ _ \ | '_ \| '_ \| | '_ \ | (_| | __/ | |_) | | | | | | | | \__,_|\___|_| .__/|_| |_|_|_| |_| |_| vagrant@delphin:~$
Now simply head to the Delphin directory:
vagrant@delphin:~$ cd /var/sources
The first step is to build Delphin, which can be a lengthy process the first time because that will download all dependencies:
vagrant@delphin:/var/sources$ yarn install
Then the only step left is just starting the application with:
vagrant@delphin:/var/sources$ yarn start
Hopefully at some point you'll see:
Server listening on http://delphin.localhost:1337 Backend listening on http://localhost:1338
You should now be able to access Delphin in your browser at http://delphin.localhost:1337!
The Delphin repository is located in
/var/sources on the sandbox. This isn't a shared folder (i.e. a directory that is shared between the virtual machine - the guest system - and your own computer - the host system). This was done for performance reason as well as to work around a number of limitations (most of them originating from running Windows as host system).
With Delphin Bootstrap you can either work from the virtual machine itself or from your computer. In the former case, you would edit files in the
/var/sources folder directly. In the latter, you would have to clone the Delphin repository to your computer and edit files there using your favorite editing tools. You would then have to sync this repository with the one on the sandbox in
/var/sources using a tool such as rsync or unison. In both cases, Delphin will pick up the changes, potentially rebuild some files, and apply them to the page in your browser.
You can shutdown the virtual machine with
vagrant halt and start it again with
vagrant up. You can also pause it with
vagrant suspend and unpause it with
Good job, you deserve a cup of coffee now!
Delphin Bootstrap is licensed under GNU General Public License v2 (or later).