Photo server 2021-2023

This is the source code for the webserver hosting pictures from the ENS Paris-Saclay student life.

The philosophy of this project is to keep this code as simple as possible to run and to maintain.

Setup

1. Dependency installation. If you are not using Debian, please feel free to adapt the following instructions.

   sudo apt install git gettext python3-django python3-django-allauth python3-django-crispy-forms python3-docutils python3-exifread python3-pil
   
   # Only for production
   sudo apt install nginx uwsgi uwsgi-plugin-python3 python3-certbot-nginx
   

2. Cloning. Change directory to where you want the project to be. In production, we usually use /var/www/photos/ as the root user.

   git clone https://gitlab.crans.org/bde/photo21.git && cd photo21
   

3. Configuration (production only).

   # Only for production
   sudo mkdir static media
   sudo cp docs/maintenance.html static/maintenance.html
   sudo chown www-data:www-data -R static media
   sudo chmod g+rwx -R static media
   sudo chmod +x maintenance_tool.sh
   sudo cp docs/uwsgi_photos.ini /etc/uwsgi/apps-available/uwsgi_photos.ini
   sudo ln -s /etc/uwsgi/apps-available/uwsgi_photos.ini /etc/uwsgi/apps-enabled/
   sudo cp docs/nginx_photos_maintenance /etc/nginx/sites-available/photos.crans.org
   sudo ln -s /etc/nginx/sites-available/photos.crans.org /etc/nginx/sites-enabled/
   sudo cp docs/letsencrypt_photos.crans.org /etc/letsencrypt/conf.d/photos.crans.org
   sudo cp docs/renewal-hooks_post_nginx /etc/letsencrypt/renewal-hooks/post/nginx
   sudo certbot --config /etc/letsencrypt/conf.d/photos.crans.org.ini certonly
   

4. Database (production only). In development, you may use SQLite (no setup). In production, we use PostgreSQL which require a bit of setup:

   sudo apt install postgresql postgresql-contrib
   sudo -u postgres psql
   postgres=# CREATE USER photo21 WITH PASSWORD 'un_mot_de_passe_sur';
   postgres=# CREATE DATABASE photo21 OWNER photo21;
   

5. Initialization., In production, please use www-data user.

   ./manage.py collectstatic
   ./manage.py check
   ./manage.py migrate
   ./manage.py compilemessages
   
   # Only when creating a new database
   ./manage.py loaddata initial
   ./manage.py createsuperuser
   # change DEBUG to True in photo21/settings.py
   

6. Maintenance Mode., In production to toggle the server mainteance mode

   ./maintenance_tool.sh

7. Enjoy \o/

   In production, the NGINX site should now work. In development, you can launch the development server using:

   (env)$ ./manage.py runserver