Skip to content

How to run the application

CogNoman edited this page Sep 28, 2018 · 2 revisions

The live website can be seen 24/7 at: http://freeforfree-216104.appspot.com/


If you want to see the application on your localhost (for testing purposes), read the following steps.

If this is the first time that you will be running the application on your computer:

  1. Download Node.js
  2. Clone our GitHub repo
  3. Open a shell/terminal
  4. cd to the cloned folder
  5. write "npm install" then "npm start"
  6. The application is now running on your localhost. To see it, open a browser and go to: http://localhost:8080/

To open the application a 2nd time, there is no need to type "npm install" again (you only type "npm install" if new dependencies have been added to the site). You simply need to:

  1. Open a shell/terminal
  2. cd to the cloned folder
  3. write "npm start"
  4. See the application in your browser at http://localhost:8080/



To access the Database (using Workbench):

  1. Find your IP address. (This can be found by googling "my ip".)

  2. Go to our Google Cloud Platform: https://console.cloud.google.com/home/dashboard?project=freeforfree-216104

  3. On our Google Cloud Platform home page, click on "SQL" (in menu bar on left side of screen).

  4. Click on the "library" instance. This opens the "Instance details" page.

  5. Scroll down to the "Connect to this instance" box. Write down the "Public IP address" and "Instance connection name". You will need those for Step #10.

  6. Scroll back up. Click on the "CONNECTIONS" Tab.

  7. Scroll down to the list of "Authorized networks". Click "Add network". Invent a name for your netork and paste your IP address (from Step #1) in to Network. Save changes.

  8. Open Workbench.

  9. On the home screen of Workbench, create a new MySQL Connection (to do this, click on the "+" sign).

  10. On the "Setup New Connection" pop-up box: "Connection Name" is name you copied in Step #5 ("Instance connection name"). "Connection Method" is "Standard (TCP/IP)". "Hostname" is the IP address from Step #5. "Username" is the username that Mikael created for you (your first name, all miniscule letters). You can just leave the "Port" at its default value. (If you're having trouble, Port 3306 should work.) Click OK.

To use Workbench: On the left Menu bar, find "SCHEMAS". Click on "freeforfreetables", then "Tables". Select any of the listed tables in order to modify it.

The next time that you want to access the database, you don't need to do any of the above steps. Just open Workbench and select the freeforfreetables Connection from your Workbench home screen.

Quick Access

Clone this wiki locally