This repo contains all code required to run our website, it is a svelte app using a custom tornado package to serve the site.
See below for basic instructions for connecting to the server hosting the website, using TMUX, and how to run and make changes to the website.
Our website's server runs on a linux server hosted by the Cybera Rapid Access Cloud (RAC). Speak with the software team lead or club president to get SSH access for the admin account.
Attach to the "Webserver" TMUX session (see below for details and commands), cd to the ~/uab directory, and run sudo ./run.sh.
TMUX is short for Terminal Multiplexer. Essentially, it is a way to have multiple terminal sessions active at once from a command line interaface.
This allows us to have 2 sessions, with different purposes. Our 3 sessions are as follows:
- Webserver: Runs the main webserver app, if this isn't running you won't be able to browse to the website.
- Applications: Handles new applications
A very basic guide to get started with TMUX can be found here and a more detailed guide here.
The prefix for all tmux commands is CTRL + B this can be changed via the tmux.conf file. Some basic commands to get you started are below.
List all sessions
tmux ls
Attach to a session
tmux attach-session -t <session name> or tmux a -t <session name>
Detach from current session
CTRL + b d
Create a new session
tmux new -s <session name>
End a session
tmux kill-session -t <session name>
python3 -m pip install tornado pysha3 pymysql