phpbb · rubencm · Jan 5, 2026
diff --git a/.gitignore b/.gitignore
@@ -44,7 +44,9 @@
 /tests/tmp/*
 /tests/vendor
 /vagrant/phpbb-install-config.yml
-.vagrant
+/vagrant/.vagrant
+/vagrant/composer.lock
+/vagrant/vendor
 node_modules

 # Excludes IDE / editors files

diff --git a/phpBB/composer.json b/phpBB/composer.json
@@ -58,7 +58,6 @@
 	"require-dev": {
 		"fabpot/goutte": "~3.2",
 		"php-webdriver/webdriver": "~1.8",
-		"laravel/homestead": "~7.0",
 		"phing/phing": "~2.4",
 		"phpunit/dbunit": "~4.0",
 		"phpunit/phpunit": "^7.0",

diff --git a/phpBB/composer.lock b/phpBB/composer.lock
diff --git a/phpBB/docs/vagrant.md b/phpBB/docs/vagrant.md
@@ -2,19 +2,21 @@

 phpBB includes support for Vagrant. This allows developers and contributors to run phpBB without the need to set up their own local web server with traditional WAMP/MAMP stacks. It also provides a consistent environment between developers for writing and debugging code changes more productively.

-phpBB uses the [Laravel/Homestead](https://laravel.com/docs/5.1/homestead) Vagrant box. It runs a Linux server with Ubuntu 14.04, PHP 5.6, Nginx, SQLite3, MySQL, and a whole lot more (complete specs below).
+phpBB uses the [Laravel/Homestead](https://laravel.com/docs/5.1/homestead) Vagrant box. It runs a Linux server with Ubuntu, PHP 7.2, Apache, SQLite3, MySQL, and a whole lot more (complete specs below).

 ## Get Started

 * Download and Install [Vagrant](https://www.vagrantup.com/downloads.html)
 * Download and Install [VirtualBox](https://www.virtualbox.org/wiki/Downloads)
-* Run `vagrant up` from the root of your cloned fork of the phpBB Git repository
+* Run `vagrant up` from the `vagrant` directory of your cloned fork of the phpBB Git repository

 ```sh
+$ cd vagrant
+$ ../composer.phar install
 $ vagrant up
 ```

-* Access phpBB at `http://192.168.10.10/`
+* Access phpBB at `http://192.168.56.56/`
 * Username: **admin**
 * Password: **adminadmin**

@@ -52,7 +54,7 @@ By default, phpBB is pre-configured to install with a MySQL database. You can, h
 If you prefer to access phpBB from the more friendly URL `http://phpbb.app` then you must update your computer's hosts file. This file is typically located at `/etc/hosts` for Mac/Linux or `C:\Windows\System32\drivers\etc\hosts` for Windows. Open this file and add the following line to it, at the very bottom, and save.

 ```
-192.168.10.10  phpbb.app
+192.168.56.56  phpbb.app
 ```

 ## How it all works
@@ -91,11 +93,11 @@ $ mysql -uhomestead -psecret phpbb < /home/vagrant/phpbb/phpBB/store/phpbb.sql

 ### Included Software

-* Ubuntu 14.04
+* Ubuntu
 * Git
-* PHP 5.6
+* PHP 7.2
 * HHVM
-* Nginx
+* Apache
 * MySQL
 * Sqlite3
 * Postgres

diff --git a/Vagrantfile → vagrant/Vagrantfile b/Vagrantfile → vagrant/Vagrantfile
@@ -2,24 +2,24 @@ require 'json'
 require 'yaml'

 VAGRANTFILE_API_VERSION ||= "2"
-confDir = $confDir ||= File.expand_path("phpBB/vendor/laravel/homestead", File.dirname(__FILE__))
+confDir = $confDir ||= File.expand_path("vendor/svpernova09/homestead", File.dirname(__FILE__))

-homesteadYamlPath = "vagrant/bootstrap.yaml"
-afterScriptPath = "vagrant/after.sh"
-aliasesPath = "vagrant/aliases"
+homesteadYamlPath = "bootstrap.yaml"
+afterScriptPath = "after.sh"
+aliasesPath = "aliases"

 require File.expand_path(confDir + '/scripts/homestead.rb')

 Vagrant.configure(VAGRANTFILE_API_VERSION) do |config|
-    if File.exists? aliasesPath then
+    if File.exist? aliasesPath then
        config.vm.provision "file", source: aliasesPath, destination: "~/.bash_aliases"
    end

-    if File.exists? homesteadYamlPath then
+    if File.exist? homesteadYamlPath then
        Homestead.configure(config, YAML::load(File.read(homesteadYamlPath)))
    end

-    if File.exists? afterScriptPath then
+    if File.exist? afterScriptPath then
        config.vm.provision "shell", path: afterScriptPath
    end
 end
diff --git a/vagrant/after.sh b/vagrant/after.sh
@@ -34,4 +34,4 @@ sed -i "s/cgi.fix_pathinfo=.*/cgi.fix_pathinfo=1/" /etc/php/${PHP_VERSION}/fpm/p
 # Restart php-fpm to apply php.ini changes
 systemctl restart php${PHP_VERSION}-fpm.service

-echo "Your board is ready at http://192.168.10.10/"
+echo "Your board is ready at http://192.168.56.56/"
diff --git a/vagrant/bootstrap.yaml b/vagrant/bootstrap.yaml
@@ -1,5 +1,5 @@
 ---
-ip: "192.168.10.10"
+ip: "192.168.56.56"
 memory: 2048
 cpus: 1
 hostname: phpbb
@@ -12,7 +12,7 @@ keys:
    - ~/.ssh/id_rsa

 folders:
-    - map: "."
+    - map: ".."
      to: "/home/vagrant/phpbb"
 sites:
    - map: phpbb.app

diff --git a/vagrant/composer.json b/vagrant/composer.json
@@ -0,0 +1,5 @@
+{
+    "require": {
+        "svpernova09/homestead": "dev-main"
+    }
+}
diff --git a/vagrant/phpbb-install-config.yml b/vagrant/phpbb-install-config.yml
@@ -46,6 +46,6 @@ installer:
        cookie_secure: false
        server_protocol: http://
        force_server_vars: false
-        server_name: 192.168.10.10
+        server_name: 192.168.56.56
        server_port: 80
        script_path: /