PHPackages                             best-it/shopware-vagrant - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. best-it/shopware-vagrant

ActiveLibrary

best-it/shopware-vagrant
========================

Vagrant setup mainly used for shopware (5)

1.1.0(4y ago)04.5kMITPHP

Since Oct 27Pushed 4y agoCompare

[ Source](https://github.com/bestit/shopware-vagrant)[ Packagist](https://packagist.org/packages/best-it/shopware-vagrant)[ RSS](/packages/best-it-shopware-vagrant/feed)WikiDiscussions master Synced today

READMEChangelog (3)DependenciesVersions (6)Used By (0)

Vagrant Shopware Box
====================

[](#vagrant-shopware-box)

Installation
------------

[](#installation)

Virtualbox and Vagrant (min. Version 2.0) have to be installed on your local machine:

- [Virtualbox](https://www.virtualbox.org/wiki/Downloads)
- [Vagrant](https://www.vagrantup.com/downloads.html)

### Vagrant installation for Debian / Ubuntu

[](#vagrant-installation-for-debian--ubuntu)

```
$ wget https://releases.hashicorp.com/vagrant/2.0.1/vagrant_2.0.1_x86_64.deb
$ sudo dpkg -i vagrant_2.0.1_x86_64.deb

```

Usage
-----

[](#usage)

### Composer

[](#composer)

Clone the repository to your local machine.

```
$ composer require --dev best-it/shopware-vagrant

```

Generate a Vagrantfile that looks like this and modify it to your needs:

```
shopware_vagrant = File.expand_path('./vendor/best-it/shopware-vagrant/Vagrantfile')
load shopware_vagrant

confDir = $confDir ||= File.expand_path(File.dirname(__FILE__))
afterScriptPath = confDir + "/after.sh"
customizationScriptPath = confDir + "/user-customizations.sh"

Vagrant.configure("2") do |config|

    config.vm.synced_folder "./shopware", "/home/vagrant/www",
        type: "rsync",
        rsync__exclude: [
            "/.env",
            "/engine/Library",
            "/var/*",
            "/web/*",
            "/media/.htaccess",
            "/.htaccess",
            "/themes/Backend",
            "/themes/Frontend/Bare",
            "/themes/Frontend/Responsive",
            "/themes/Frontend/Session/node_modules",
            "/Plugins/Local/Backend/SwagImportExport/psh",
            "/custom/plugins/SwagPaymentPayPalUnified/psh"
        ]

    config.ssh.forward_agent = true

    if File.exist? afterScriptPath then
        config.vm.provision "shell", path: afterScriptPath, privileged: false, keep_color: true
    end

    if File.exist? customizationScriptPath then
        config.vm.provision "shell", path: customizationScriptPath, privileged: false, keep_color: true
    end
end

userVagrantfilePath = confDir + "/user-vagrantfile"
load userVagrantfilePath if File.exists?(userVagrantfilePath)

```

Generate an ansible folder

```
$ mkdir ansible

```

Add a playbook that looks like this:

```
---
- name: apply common configuration to all nodes
  hosts: all
  roles:
    - role: '../vendor/best-it/shopware-vagrant/ansible/roles/common'
    - role: '../vendor/best-it/shopware-vagrant/ansible/roles/apache'
    - role: '../vendor/best-it/shopware-vagrant/ansible/roles/mysql'
    - role: '../vendor/best-it/shopware-vagrant/ansible/roles/adminer'
    - role: '../vendor/best-it/shopware-vagrant/ansible/roles/ioncube'
    - role: '../vendor/best-it/shopware-vagrant/ansible/roles/composer'
    - role: '../vendor/best-it/shopware-vagrant/ansible/roles/nodejs'
    - role: '../vendor/best-it/shopware-vagrant/ansible/roles/sw-cli-tools'
    - role: '../vendor/best-it/shopware-vagrant/ansible/roles/grunt'

```

### Without composer

[](#without-composer)

Clone the repository to your local machine.

```
$ git clone https://github.com/shopwareLabs/shopware-vagrant
$ cd shopware-vagrant

```

Boot up your vagrant virtual machine:

```
$ vagrant up

```

The first boot may take a while, so feel free to get a cup of coffee.

Your machine will be available at All required tools like the LAMP stack are already installed.

- Adminer (DB-Administration):
- MySQL user: `root`, password: `shopware`

To SSH into the created VM:

```
$ vagrant ssh

```

If you use Putty the ssh configuration can be obtained via:

```
$ vagrant ssh-config

```

To reprovision your machine:

```
$ vagrant provision

```

Access files on Host machine
----------------------------

[](#access-files-on-host-machine)

To start local development, it is recommended to sync the source shopware folder to a local folder. To do this, uncomment one of the config.vm.synced\_folder lines in the Vagrantfile file.

```
#config.vm.synced_folder "../src", "/home/vagrant/www/shopware", create: true, type: "smb"
#config.vm.synced_folder "../src", "/home/vagrant/www/shopware", create: true, type: "nfs"
#config.vm.synced_folder "../src", "/home/vagrant/www/shopware", create: true;

```

For example, for MacOS:

```
config.vm.synced_folder "src", "/home/vagrant/www/shopware", create: true, type: "nfs"

```

After editing the vagrant file, make sure to reload your instance.

```
$ vagrant reload

```

### Troubleshooting

[](#troubleshooting)

- Error message "The 'ansible\_local' provisioner could not be found.":

Make sure vagrant is at least at version 2.0:

```
$ vagrant -v

```

- Unable to mount directory (MacOS), given error message:

    ```
      Got different reports about installed GuestAdditions version:
      Virtualbox on your host claims:   5.0.18
      VBoxService inside the vm claims: 6.0.8
      Going on, assuming VBoxService is correct..."

    ```

Make sure GuestAdditions are same versions:

```
$ vagrant vbguest --do install
$ vagrant reload

```

Change PHP Version
------------------

[](#change-php-version)

The following PHP Versions are installed by default:

- PHP 7.0
- PHP 7.1
- PHP 7.2

Call one of the following commands to change the PHP Version:

```
$ changephp_7.0
$ changephp_7.1
$ changephp_7.2

```

This will change the PHP Version used by the Apache webserver as well as the Version of the `php` command.

You can also call the PHP versions directly using their full path

```
$ /usr/bin/php7.0 -v
$ /usr/bin/php7.1 -v
$ /usr/bin/php7.2 -v

```

Installing Shopware
-------------------

[](#installing-shopware)

SSH first into your VM:

```
$ vagrant ssh

```

Call the `install_shopware` script:

```
$ install_shopware

```

This will download the latest git version of shopware and install it into `/home/vagrant/www/shopware`.

Download test images:

```
$ cd /home/vagrant/www/shopware
$ wget -O test_images.zip http://releases.s3.shopware.com/test_images_since_5.1.zip
$ unzip test_images.zip

```

Configure your online store in a web browser with the credentials demo/demo:

- Backend:

You can then access your storefront at:

- Front-end:

Notes for Arch Linux users
--------------------------

[](#notes-for-arch-linux-users)

```
$ sudo pacman -S virtualbox ansible net-tools nfs-utils
$ sudo modprobe -a vboxdrv vboxnetadp vboxnetflt
$ sudo systemctl start nfs-server

```

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE) for more information.

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity17

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~113 days

Total

3

Last Release

1796d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/acc5af332f2a79dedb5aea83c3b4c2665d99fd2c14743fd0c2a3d70ecf0b7859?d=identicon)[best-it](/maintainers/best-it)

---

Top Contributors

[![bcremer](https://avatars.githubusercontent.com/u/55820?v=4)](https://github.com/bcremer "bcremer (33 commits)")[![teiling88](https://avatars.githubusercontent.com/u/4624237?v=4)](https://github.com/teiling88 "teiling88 (15 commits)")[![shyim](https://avatars.githubusercontent.com/u/6224096?v=4)](https://github.com/shyim "shyim (4 commits)")[![sebastien-fauvel](https://avatars.githubusercontent.com/u/4215521?v=4)](https://github.com/sebastien-fauvel "sebastien-fauvel (3 commits)")[![larsbo](https://avatars.githubusercontent.com/u/754074?v=4)](https://github.com/larsbo "larsbo (2 commits)")[![JoshuaBehrens](https://avatars.githubusercontent.com/u/1133593?v=4)](https://github.com/JoshuaBehrens "JoshuaBehrens (2 commits)")[![fboes](https://avatars.githubusercontent.com/u/1560792?v=4)](https://github.com/fboes "fboes (2 commits)")[![mitelg](https://avatars.githubusercontent.com/u/6985627?v=4)](https://github.com/mitelg "mitelg (2 commits)")[![numediaweb](https://avatars.githubusercontent.com/u/288614?v=4)](https://github.com/numediaweb "numediaweb (2 commits)")[![Robin-Marquardt](https://avatars.githubusercontent.com/u/35999619?v=4)](https://github.com/Robin-Marquardt "Robin-Marquardt (1 commits)")[![runelaenen](https://avatars.githubusercontent.com/u/3930922?v=4)](https://github.com/runelaenen "runelaenen (1 commits)")[![tim-kellner](https://avatars.githubusercontent.com/u/15520044?v=4)](https://github.com/tim-kellner "tim-kellner (1 commits)")[![Ziumper](https://avatars.githubusercontent.com/u/16363882?v=4)](https://github.com/Ziumper "Ziumper (1 commits)")[![bestit-el-bardan](https://avatars.githubusercontent.com/u/24458969?v=4)](https://github.com/bestit-el-bardan "bestit-el-bardan (1 commits)")[![cedrix-bestit](https://avatars.githubusercontent.com/u/61840425?v=4)](https://github.com/cedrix-bestit "cedrix-bestit (1 commits)")[![dnoegel](https://avatars.githubusercontent.com/u/1114384?v=4)](https://github.com/dnoegel "dnoegel (1 commits)")[![Gugiman](https://avatars.githubusercontent.com/u/5836639?v=4)](https://github.com/Gugiman "Gugiman (1 commits)")[![jhit](https://avatars.githubusercontent.com/u/537665?v=4)](https://github.com/jhit "jhit (1 commits)")[![LiaraAlis](https://avatars.githubusercontent.com/u/297882?v=4)](https://github.com/LiaraAlis "LiaraAlis (1 commits)")[![migo315](https://avatars.githubusercontent.com/u/13180135?v=4)](https://github.com/migo315 "migo315 (1 commits)")

### Embed Badge

![Health badge](/badges/best-it-shopware-vagrant/health.svg)

```
[![Health](https://phpackages.com/badges/best-it-shopware-vagrant/health.svg)](https://phpackages.com/packages/best-it-shopware-vagrant)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
