oval

Free classroom-oriented instructor-moderated question and answer forum. Inspired by Piazza.

Setting up the app

1. Install dependencies
   • PostgreSQL, Python3, pip: sudo apt install build-essential postgresql libpq-dev python3 python3-pip
   • Flutter
2. Set up database
   1. Start the Postgres service: sudo service postgresql start
   2. Change the password of the postgres user
      1. Open psql: sudo -u postgres psql
      2. Change the password: \password postgres
         • Remember this, you'll need it later!
      3. Quit psql: \q
   3. Create the Oval database: sudo -u postgres createdb oval
   4. Change Postgres's authentication mode
      1. Find the configuration file: sudo -u postgres psql -c "show hba_file;"
      2. Open the configuration file: sudo vim [configuration file path]
      3. Change "md5" to "password" in these lines:

         # IPv4 local connections:
         host    all             all             127.0.0.1/32            md5
         # IPv6 local connections:
         host    all             all             ::1/128                 md5
         

3. Set up back end
   1. Navigate to the back end directory
   2. Install the dependencies in the Django project: pip3 install -r requirements.txt
   3. Set up the environment variables file
      1. Copy .env.example and rename it to .env
      2. Populate the fields in the file
   4. Run Django migrations: python3 manage.py migrate
4. Set up front end
   1. Navigate to the front end directory
   2. Install the dependencies in the Flutter project: flutter pub get
   3. Set up the environment variables file
      1. Copy .env.example and rename it to .env
      2. Populate the fields in the file

Running the app

1. Run back end: python3 manage.py runserver
2. Run front end: flutter run