OnlyBruins 🐻

Bringing audiences to Bruin creators through unique user experiences.

Setup

Clone this repository

git clone https://github.com/onlybruins/onlybruins.com
cd onlybruins.com

Install Node.js LTS

On Ubuntu,

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

Set up PostgreSQL

On Ubuntu,

sudo apt install postgresql postgresql-contrib
sudo -u postgres createuser --superuser $USER
createdb onlybruinsdb

We didn't implement database authentication. To let the server connect to Postgres, edit /etc/postgresql/14/main/pg_hba.conf (where 14 is your Postgres major version number) and change these lines:

# IPV4 local connections:
host    all             all             127.0.0.1/32            XXX
# IPv6 local connections:
host    all             all             ::1/128                 XXX

to read trust in place of XXX.

Prepare to run latest code

git pull # Get the latest code on main
npm install
sudo systemctl restart postgresql.service # On WSL, sudo service postgresql restart
psql onlybruinsdb -f setup.sql # Update with latest schema. ⚠️THIS WILL DROP EXISTING DATA.
rm ugc-images/*/* # Remove all post images, which are unreferenced after setup.sql cleared the tables

Run Locally

During development, for frontend (not backend!) hot-reloading run

npm run --prefix backend build
npm run dev

Alternatively, to serve everything from the backend run

npm start

and navigate to http://localhost:8080.

Run in Production

Ports below 1024 are privileged on Linux, but we need ports 80/443 to serve HTTP/HTTPS. Use this one-time setup to let Node use privileged ports:

sudo setcap 'cap_net_bind_service=+ep' `which node`

From the onlybruins.com directory, run

NODE_ENV=production npm start

If you use SSH and want to leave the server running after you disconnect, run

npm run build
NODE_ENV=production nohup node backend >onlybruins.log 2>&1 <&- &

Remember to kill this process if you want to run a more recent version of the server.

HTTPS

OnlyBruins will always serve HTTP. If it finds privatekey.key and certificate.pem in your $HOME, it will also serve HTTPS.