TRT Tiger ReTail

an online web platform for Princeton students to buy/sell/request goods

Running locally

Initial setup

1. Create a new conda environment: conda create -n tigerretail
2. Activate the conda environment: conda activate tigerretail
3. Install python: conda install python=3.10
4. Clone this repo and cd into the base TigerReTail directory
5. Install dependencies: pip install -r requirements.txt
   • If you're running into a psycopg2 error (pg_config executable not found), you probably have to install postgresql: https://stackoverflow.com/a/24645416
6. Run conda list to validate that all packages in requirements.txt were installed.
7. Set all environment variables:
   • Login to Heroku and go to the Settings tab for the trt-dev app (do NOT use prod!)
   • Reveal Config Vars
   • For each Config Var key-value pair, create a local environment variable: conda env config vars set key=value (replace key and value with the actual key and value)
   • After setting all env vars, reactivate your conda environment: conda activate tigerretail
   • Note that for SECRET_KEY, you might get an error so you can set its value to 1
8. Run conda env config vars list to validate all env vars were set.

Running the dev server

After following the initial setup steps above, you can run the local development server:

1. cd into the TRT-django directory (a subfolder of the base directory)
2. Activate your environment: conda activate tigerretail
3. Run the server: python manage.py runserver
   • Visit http://localhost:8000/ to verify the server is up and running. Note that you probably won't see most of the listing pictures.