How to use this box with Vagrant:
Vagrant.configure("2") do |config|
config.vm.box = "aracpac/centos8-stream"
config.vm.box_version = "1.4.1"
endvagrant init aracpac/centos8-stream \
--box-version 1.4.1
vagrant up
This version was created almost 3 years ago.
This CentOS 8 Stream virtual machine is preconfigured with support for a variety of full stack web development frameworks, including:
Download a turbocharged Vagrantfile made specifically for this box.
The quickstart assumes you've:
vagrant up from a command shell within that directoryvagrant ssh to connect to the guest machine/var/www inside the guest machine and removed any existing files in the directoryNow find the name of the framework you want to work with in the following list. Under the name of the framework are the
shell commands you'll need to run to initialize a new project and to start seeing your work on your host machine's web
browser (just navigate to the URL adjacent the framework name after you've run all the commands). The first time you
access the box via an HTTPS url, you will get a browser-specific error like MOZILLA_PKIX_ERROR_SELF_SIGNED_CERT or
NET::ERR_CERT_AUTHORITY_INVALID — this is expected due to the self-signed certificate generated in the virtual
machine. Follow the prompts in your browser to trust the certificate and proceed.
✅ LAMP ( https://dev.local/ )
# everything is preconfigured and you can start modifying `/var/www/index.php` immediately
✅ Symfony ( https://dev.local/ )
symfony new . --full
# install apache support (be sure to answer 'y' when prompted to run the recipe)
composer require symfony/apache-pack
# update the default vhost to match symfony's file structure
sudo sed -i -e 's/var\/www.*$/var\/www\/public/g' /etc/httpd/conf.d/vhosts.conf
# restart httpd to reload the vhost
sudo systemctl restart httpd
# create a local .env override and add the local machine's database information
cat .env | sed -e 's/db_user:db_password/vagrant:vagrant/g' > .env.local
# create the database
bin/console doctrine:database:create --if-not-exists --no-interaction
✅ Laravel (https://dev.local/ )
composer create-project laravel/laravel .
# update the default vhost to match Laravel's file structure
sudo sed -i -e 's/var\/www.*$/var\/www\/public/g' /etc/httpd/conf.d/vhosts.conf
# restart httpd to reload the vhost
sudo systemctl restart httpd
✅ CakePHP ( https://dev.local/ )
composer create-project cakephp/app .
# update the default vhost to match CakePHP's file structure
sudo sed -i -e 's/var\/www.*$/var\/www/g' /etc/httpd/conf.d/vhosts.conf
# restart httpd to reload the vhost
sudo systemctl restart httpd
✅ CodeIgniter ( https://dev.local/ )
composer create-project codeigniter4/appstarter .
# update the default vhost to match CodeIgniter's file structure
sudo sed -i -e 's/var\/www.*$/var\/www/g' /etc/httpd/conf.d/vhosts.conf
# restart httpd to reload the vhost
sudo systemctl restart httpd
✅ Angular ( http://dev.local:4200/ )
ng new web --directory .
ng serve --host 0.0.0.0 --disable-host-check
✅ Ember ( http://dev.local:4200/ )
ember init
ember serve --host 0.0.0.0
✅ Express ( http://dev.local:3000/ )
express --view=twig .
npm install
DEBUG=.:* npm start
✅ Vue ( http://dev.local:8080/ )
vue create .
# create a vue.config.js file and disable host checking so we can view our work from the host machine
echo "module.exports = { devServer: { disableHostCheck: true } }" > vue.config.js
yarn serve --host 0.0.0.0 --public $(hostname)
✅ React ( http://dev.local:5000/ )
create-react-app .
serve -s public
✅ Java Spring ( http://dev.local:8080/ )
spring init --dependencies=web ./
mvn spring-boot:run
✅ Ruby on Rails ( http://dev.local:3000/ )
rails new .
# whitelist all IPs in config/environments/development.rb so we can view our work from the host machine
sed -i "\$i config.hosts << \"$(hostname)\"\nconfig.web_console.whitelisted_ips = '0.0.0.0/0'" config/environments/development.rb
rails server -b 0.0.0.0
✅ Django ( http://dev.local:8080 )
django-admin startproject web .
# whitelist all hosts in web/settings.py so we can view our work from the host machine
sed -i -e 's/^ALLOWED_HOSTS = \[\]$/ALLOWED_HOSTS = ["*"]/g' web/settings.py
python3 manage.py runserver 0.0.0.0:8080
✅ ASP.Net ( http://dev.local:5000 )
dotnet new webapp -o .
dotnet run --urls "http://0.0.0.0:5000" --project .
Traditionally, a major downside of developing in a virtual machine has been synced folders. Because the host machine (your desktop) and the guest machine (the virtual machine) are two logically separate operating systems, files on one filesystem are not immediately accessible to the other. This is a challenge if you want to work on your code using your favorite desktop IDE, but the code requires the software and infrastructure of the virtual machine to actually run. The most common solution is using a synced folder, which syncs code from one environment to the other using rsync, NFS, samba, etc.
Unfortunately, synced folders have some performance penalty, especially on projects that require constance recompilation (think most JavaScript frameworks). On the one hand, you could run your code locally on your desktop and mount your working folder to your virtual machine. This is the default vagrant behaviour, and it allows for a speedy IDE experience with code analysis, refactoring, linting, and all the other IDE goodies. Unfortunately, this setup can cause a delay between the work you're doing and the results you see in the browser.
AracPac can support the default vagrant behaviour but uses a different approach sometimes called a reverse mount. Here,
the Vagrantfile is used to automatically mount the /var/www directory from the virtual machine to your project
directory on your computer. Though a reverse mount can make some IDE features a little less responsive, there are big
wins in terms of how quickly your work is displayed in the browser, which makes debugging code and working on features a
much nicer experience.
In addition to using reverse mounts, AracPac comes preinstalled with Projector, which is an exciting new project from JetBrains. JetBrains IDEs use Swing to draw the GUI. Projector allows Swing GUIs to be rendered over a network. The JetBrains IDE is installed and runs server-side, but instead of rendering the GUI on the server, it renders it via the Projector application on your desktop. In practice, this feels like you're running the IDE natively and mitigates many of the reverse mount penalties. Due to size considerations, only PHPStorm is preinstalled in the virtual machine, but any JetBrains IDE can be installed using the projector CLI inside the virtual machine.
Mailcatcher runs a local mail server and allows you to review mail sent to it from a web browser on your host machine. This can be very useful during development.
Run Mailcatcher by using a command shell on the guest machine:
mailcatcher --http-ip 0.0.0.0
Mailcatcher will run in the background as a daemon. If you want to route all local mail to port 1025 so Mailcatcher will
catch it, just add a line to /etc/postfix/main.cf:
relayhost = [localhost]:1025
Now use a command shell to send a test message:
echo "Mailcatcher test!" | mail -s "Testing 1, 2 ,3" -r from@email.address to@email.address
Finally, use a web browser on your host machine and review your caught messages at http://dev.local:1080/. messages.
root user with password root
vagrant user with password vagrant, passwordless sudo, and an entry for the vagrant insecure key
in ~/.ssh/authorized_keys
apache listening on port 80 and 443 and serving from /var/www
java 8 / 11 / 16 JDKs and JREs (with 11 set as the default)mysql listening on port 3306 and with root password root
mongodb configured to listen on 27017 but disabled by defaultpostgresql listening on port 5432 and with vagrant password vagrant
php-xdebug installed and available on port 9003 but disabled by defaultprojector installed, with PHPStorm installed as a service (projector_phpstorm) on port 9999 but
disabled by defaultvarnish configured to listen on 8080 but disabled by defaultnginx installed but disabled by defaultnfsd installed and configured with the following
share: /var/www *(all_squash,anonuid=1000,anongid=1000,async,crossmnt,insecure,nohide,fsid=9999,rw)
firewalld installed, enabled, and configured for the stackselinux configured for all installed packages and servicesdev.crt and dev.pem in /etc/ssl
500G VirtualBox primary disk (useful on larger projects -- most publicly available boxes have 40G disks)apache daemon's umask set to 0002
vagrant user belongs to the apache group; apache user belongs to the vagrant groupaclatopbash-completionbyobucomposercurldocker-cegitgolanghtopiotopjavamavenmemcachednodejsncatpvvimrsyncrustcsendmailsqlitesubversionsupervisorsymfonytreeunzipvimwgetzip