ryanstreet / magento2-vagrant

Vagrant Setup for Magento 2 install. All prerequisites setup and running.
GNU General Public License v2.0
84 stars 32 forks source link

Vagrant for Magento2

Update

Magento 2 codebase now lives in folder. You must run an additional command to install Magento 2!

Vagrant Setup for Magento 2 install. All prerequisites setup and running.

Installs all requisites for Magento 2. Utilizes Ubuntu 14.04.

You can reference the Magento2 installation guide here.

Prerequisites

Virtualbox

VirtualBox is an open source virtualizer, an application that can run an entire operating system within its own virtual machine.

  1. Download the installer for your laptop operating system using the links below.
  2. Run the installer, choosing all of the default options.
    • Windows: Grant the installer access every time you receive a security prompt.
    • Mac: Enter your admin password.
    • Linux: Enter your root password if prompted.
  3. Reboot your laptop if prompted to do so when installation completes.
  4. Close the VirtualBox window if it pops up at the end of the install.

Vagrant

Vagrant is an open source command line utility for managing reproducible developer environments.

  1. Download the installer for your laptop operating system using the links below.
  2. Run the installer, choosing all defaults.
  3. Reboot your laptop if prompted to do so when installation completes.

Usage

After Vagrant and Virtualbox are setup, run the following commands to install the Dev Box.

Clone the Repository

git clone https://github.com/ryanstreet/magento2-vagrant.git

Navigate to the folder

cd /path/to/magento2-vagrant/

Install Magento 2 Repo

git submodule init
git submodule update

This operation can be quite long, especially the last moments. Do not quit until done unless the Magento 2 repository won't be completely configured.

(Optional) Add Github Personal Access Token

Read this guide to get a personal access token. Once you have created the token, open up the Vagrantfile and place the token here:

githubToken = ""

Note: If you did not enter a personal access token, Composer will not run automatically. You will have to run it yourself to finish installation.

Run Vagrant Command

vagrant up

The configuration process will take a while, especially if it is the first time you use a vagrant box with this virtual machine, because this one had to be completely downloaded at the first utilization.

Once completed, you can connect via SSH to your virtual machine, with putty for example. The address and the port are usually 127.0.0.1 and 2222 respectively, but it can change if you have many VMs running at the same time.

Download Magento 2 Once your VM is running, connect to it via SSH and go to the /var/www/html/magento2 directory. There run the command

composer install

This will download all the components of the vendor folder of Magento 2. These components are required to use this application. It will take a while, and after that, you installation will be completed, and you will be able to acces to your magento 2 installation via your browser.

Other Info

Database Username: root
Database Password: (none)
SSH Login : vagrant
SSH Password : vagrant
root user password: vagrant
Database Name: magento
URL of Instance: http://192.168.33.10/magento2/
Host File Configuration: 192.168.33.10 www.magento2.dev magento2.dev

Issue Reporting

Any and all feedback is welcome. Please let me know of any issues you may find in the bug tracker on github. You can find it here.