Skip to content
A Vagrant setup ready for shopware platform development
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
ansible Change apache2 running user/group to vagrant:vagrant Aug 23, 2019
.gitignore Fix git URL Apr 10, 2019 Implement nginx role, HTTP/2 and SSL setup. Aug 19, 2019
Vagrantfile fix blocking provisioning by package keyboard-configuration Aug 21, 2019

Shopware Development build with Vagrant

Table of contents

  1. Vagrant VM
  2. Installation
  3. Usage
  4. Shopware Dev setup
  5. Useful vagrant commands
  6. Connecting your IDE

Vagrant VM

If using docker is not an option for you, vagrant is another great technology to quickly get a local Shopware up and running.

Other than with the docker or local setup, with vagrant you will have a complete seperate server on your machine.

Because of technical reasons, the vagrant machine acts like a remote web server, so with this setup, you'll develop your code on your PC like and then you upload/synchronize it to the vagrant machine.

For this, the vagrant machine supports SCP/SSH, which is integrated in Editors like PHPStorm or Visual Studio Code.


You need VirtualBox, Vagrant (min. Version 2.0) and Git installed locally on your machine.

The IP address is used by the vagrant box, so it must not be in use in the network already. If this is not possible, you manually have to change the IP address in the Vagrantfile you'll clone in the next step.


This section explains the basic setup of the virtual machine, as well as an advanced setup, using a reverse proxy and SSL.

Basic setup

Start by cloning this repository to your local machine

$ git clone
$ cd shopware-platform-vagrant

Boot up the virtual machine by executing vagrant up

$ vagrant up

The first boot takes a while due to box download and ansible provisioning. Feel free to grab a drink.

After the process completes your virtual machine will be up an running with your development environment ready to use.

The storefront will be available at

The administration will be available at

Credentials for ssh access are vagrant/vagrant.

You connect via vagrant ssh or use credentials and ssh with the following command (make sure ssh known_hosts is correct):

$ ssh vagrant@

Advanced setup

If you would like to access the Shopware instance using a hostname, rather than the IP address, you can enable the reverse proxy and - if you like - SSL encryption.

Both proxy and SSL can be enabled by editing the ansible/vars/all.yml. In this file, you will find the following options and be able to modify them accordingly.

Variable Type Default Description
proxy_enabled Boolean (yes/no) no Enables the installation of nginx as a reverse proxy
proxy_hostname Hostname "shopware.local" Defines the hostname that will be used to access the Shopware instance
proxy_ssl Boolean (yes/no) no Enables SSL

Please notice that you will have to modify your hosts file or use the Vagrant Hostsupdater plugin, when using a reverse proxy setup.

Given the hosts entry is set, you can access the Shopware instance via https://<proxy_hostname>, whereas <proxy_hostname> is a placeholder for the configured hostname (shopware.local per default).

Shopware Dev setup

For more info on the Shopware dev setup visit our Shopware platform docs or take a look at the vagrant guide

Useful vagrant commands

Connect to your VM via ssh

$ vagrant ssh 

(Re-)provision your environment

$ vagrant provision

Delete your VM

$ vagrant destroy

Status of your VM

$ vagrant status

Connecting your IDE

The vagrant box fully encapsulates the whole platform with all its sources. So the development process works just like with any other foreign system. The machine supports SCP with the following credentials.

Key Setting
User vagrant
Password vagrant
Path /~/shopware-dev
You can’t perform that action at this time.