Local Installation on Mac or PC using Vagrant

Support Respond! You can support the development of Respond 6 by using our Digital Ocean referral Code. This helps us pay for hosting.

Are you ready to get started with Respond? This tutorial will show you how to install Respond locally on your Mac or PC using VirtualBox and Vagrant. This is a great way to try out Respond before committing to a full server install. Plus you will learn all the skills you need to setup Respond on the server.

Before we get started, read about the server requirements. If you are an experience developer, you might also want to checkout out our documentation on installing the app from Github. This requires a little more work but gives you a number of long-term benefits.

1. Install VirtualBox and Vagrant

First download and install VirtualBox from the virtualbox.org site. Next, install Vagrant from the Vagrant site.

2. Create a Local Folder to hold your Vagrant setup

You can set this up anywhere on your local drive. You can use the command prompt or use explorer to create the folder.

// create a local directory
mkdir my-vagrant-directory

// navigate to the directory
cd my-vagrant-directory

3. Clone Respond Box

We have modified the Scotch/Box Vagrant configuration to setup our VirtualBox. Scotch/Box is a pre-configured LAMP stack running on Ubuntu. We have added a custom setup script to make installing Respond really easy. FYI, you do need git installed locally to continue

// clone scotch/box to respond directory
git clone https://github.com/madoublet/respond-box respond

// switch to the new directory
cd respond

3. Launch Vagrant and SSH into the Box

Launch the Vagrant VirtualBox using the vagrant up command.

// launch vagrant
vagrant up

// ssh into vagrant and login using the vagrant username
vagrant ssh

4. Run Setup

Now, we just run the pre-configured setup file and you are ready to go.

// go to your HTML root
cd /var/www

// run setup
bash setup

5. Test installation and create site

Navigate to to test your installation. You should see all checks under the requirements. You can then create your site at the default passcode is "iloverespond". This can be changed in your .env file or removed if you set it to blank.