Development workflow

Firstly, start your virtual machine.

vagrant up

Note. Vagrant may ask for your password so that it can update the /etc/hosts file.

Afterwards, you can find the development server under http://de.serlo.local or http://en.serlo.local respectively.

Note. If this doesn't work, try http://de.serlo.local:4567 resp. http://en.serlo.local:4567 instead.

All changes you make will be automatically synchronized to the virtual machine's file system. Do vagrant ssh to open a SSH session on the virtual machine.

When you're done with your session, stop the virtual machine.

vagrant halt

Note. You may have to stop the vagrant up script with CTRL+C beforehand. Also Vagrant may ask again for you password, to undo the changes to /etc/hosts.

Common tasks

• Editor development workflow
• Sharing your local environment
• TODO: Introduction to Front End Development (CSS-, JavaScript-related stuff)
• TODO: Introduction to Back End Development (PHP-related stuff)

Accelerating the application

Using build class and template maps may accelerate the application.

vagrant ssh
sh bin/vagrant/build.sh

Updating the user interface

For issues with Exceptions caused by Assetic or to update the frontend dependencies:

vagrant ssh
sh bin/vagrant/clean-build.sh

Updating or resetting the database

When the database out of date, or to reset the database,

vagrant ssh
sh bin/vagrant/update-mysql.sh

Updating composer dependencies

vagrant ssh
cd /var/www
php composer.phar update

Resetting the virtual machine

vagrant destroy
vagrant up