Dev's Guide: Running from source

This page explains how to run Judgels locally from source.

Prerequisites

Copy the example config file:

cp var/conf/judgels-server.yml.example var/conf/judgels-server.yml

Create a new local MySQL database called judgels.
Open the config file var/conf/judgels-server.yml.
Under database:, modify user and password as necessary so that we can connect to the judgels database.
Run database migration:
```
../gradlew dbMigrate
```
Verify that there are new tables generated in the database.
Finally, run the server app:
```
../gradlew run
```
Verify that we can open the server admin app at http://localhost:9101.
Verify that we can log in as the default superadmin user (username: superadmin, password: superadmin).

Still in judgels-backends/judgels-server-app, untar the *.tar.gz files from seeds/ to var/data:

tar -xf ../../seeds/problems.tar.gz -C var/data/
tar -xf ../../seeds/lessons.tar.gz -C var/data/
tar -xf ../../seeds/submissions.tar.gz -C var/data/

The seed data contains:

6 users with the following usernames: andi, budi, caca, dudi, emir, fuad. Passwords are equal to the usernames.
Sample problems, lessons, and submissions data.

Copy the example config:

cp public/var/conf/judgels-client.js.example public/var/conf/judgels-client.js

(Optional) If you are developing for TLX, open the config file (public/var/conf/judgels-client.js) and change window.conf.mode to TLX.
Install client app dependencies:
```
yarn install
```
Finally, run the client app:
```
yarn start
```
Verify that we can open the client app at http://localhost:3000.

Congratulations, you have successfully run Judgels from source!