Skip to content

Development Environment

Jump to bottom
Tom Udding edited this page Jul 16, 2021 · 19 revisions

To prepare the development environment, you will first need to choose how to deploy your application:

  • If you use windows, you are recommended to make use of WSL2 and run Docker 'natively' on Linux.
  • If you cannot use WSL2 on Windows, you are recommended to make use of a Virtual Machine running Linux.
  • On native Linux you will get the best performance and support for tooling.

Minimum required tools:

  • docker
  • docker-compose
  • git

Windows

  1. Install Ubuntu 20.04 LTS on WSL2 as described here.
  2. Follow the steps under Linux.

As WSL does currently not provide support for GUIs you may want to use Windows applications to edit the files. WSL exposes its files to Windows under \\wsl$\Ubuntu\ (a network location), which you can easily specify in PhpStorm or your preferred IDE.

Virtual Machine (on Windows)

  1. Install VirtualBox on your device. You can also use Hyper-V or an other alternative if you know how to use it.
  2. Download an .iso image for Ubuntu or your favorite Linux distribution of choice.
  3. Create a new Virtual Machine using the image you downloaded.

You can now follow the rest of the steps under Linux.

Linux

Assuming you use Ubuntu, the steps are as follows:

  1. Install Docker Engine for Ubuntu as described here.
  2. Install Docker Compose for Linux as described here.
  3. Clone this repository: git clone [email protected]:gewis/gewisweb.git *.

*: It is recommended you use SSH keys to connect to GitHub, read more about how to use SSH keys with GitHub here.

If you use any other Linux distribution, we trust you know how to use it.

Further Installation Steps

To actually use the website you have to build the Docker container(s), see the Docker Deployment page for more details on how to do this. Afterwards, you should be able to access the website through http://localhost.

For editing project files, a good IDE is very helpful as it can provide hints while typing.

We recommend to use PhpStorm as an IDE and note that you are able to get a free professional license using your @student.tue.nl email address. You will need to renew this license yearly.

If you are unfamiliar with Git, you can use GitKraken or any other Git client which provides an easy-to-use user interface.

To get an optimal development experience, you can install additional tools that can aid the process. Read more about that on the Development aids page.

Home

Clone this wiki locally