If you have an error at any point, please stop and ask.
  1. Open the Windows store.
  2. Search for "Ubuntu".
  3. Pick the application called "Ubuntu 18.04" (note version! not the bare "Ubuntu" application - you may have installed that during the cloud week) and click "Get".
  4. Wait for it to install. It's likely to pause for a long time around 90% done; you can do other things while it runs.
  5. Open the start menu and choose the just-installed Ubuntu application.
  6. Wait for it to be ready. This will also take a few minutes.
  7. Provide a username for it to use internally when prompted. It will be slightly more convenient to use the same name as your ECS account.
  8. Enter a password. You will need to use it occasionally, so make sure you remember it.
  9. Type: sudo apt update && sudo apt upgrade and press Enter. You will be asked for the password you just chose.
  10. Press Enter when asked if you want to continue.
  11. Wait for it to finish.
  12. Type: sudo apt install apache2 libapache2-mod-php php7.2-mysql php7.2-curl php7.2-gd and press Enter.
  13. Press Enter when asked if you want to continue.
  14. Wait for it to finish.
  15. Find the directory path to your Eclipse project (or wherever you're building your website). The remaining instructions will assume it was C:\Users\YOU\eclipse-workspace\mywebsite - change the following instruction as appropriate to your path.
  16. Type: sudo ln -s /mnt/c/Users/YOU/eclipse-workspace/mywebsite /var/www/html/first and press Enter (note forward slashes and spaces, and particularly that there is a space before "/var"). If there is a space in any of the directory names, precede it by a backslash (if you have many spaces in the path, flag us down to tell you how to quote it)
  17. Type: sudo apache2ctl start and press Enter.
  18. Go to http://localhost/first/ in your browser and see your site working.

Error reporting

  • Open the Ubuntu application again.
  • Type: sudo vim /etc/php/7.2/apache2/php.ini and press Enter.
  • Type:
    /display_errors =
    and press Enter.
  • Press these keys one after another: $ c a w (dollar sign, letter c, letter a, letter w)
  • Type: On
  • Press Escape.
  • Press these keys one after another: : x (colon, letter x) and press Enter.
  • Type: sudo apache2ctl restart and press Enter.

After a reboot

  • Open the Ubuntu application again.
  • Type sudo apache2ctl start
  • You can close the window now.

Setting up a database server

  • Open the Ubuntu application
  • Type sudo apt install mariadb-server mariadb-client mongodb curl and press Enter.
  • Press Enter when prompted to continue.
  • Type sudo /etc/init.d/mysql start and press Enter.
  • Type sudo mysql -u root and press Enter.
  • Type CREATE USER 'myuser'@'localhost' IDENTIFIED BY 'mypass'; and press Enter.
  • Type CREATE DATABASE mydb; and press Enter.
  • Type GRANT ALL ON mydb.* TO 'myuser'@'localhost'; and press Enter.
  • Press Ctrl-D.
  • Type mysql -u myuser -pmypass mydb and press Enter to enter an SQL client. Press Ctrl-D to close it after checking that it started. We will run this again to enter the program that lets us run database commands.
  • After a reboot you will need to run sudo /etc/init.d/mysql start again.