75 lines
2.1 KiB
Markdown
75 lines
2.1 KiB
Markdown
# Photo server 2021-2023
|
|
|
|
This project is a fork of [Photo21](https://gitlab.crans.org/bde/photo21/) developped at ENS Paris-Saclay.
|
|
|
|
[](https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
|
|
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.
|
|
|
|
```bash
|
|
sudo apt install git gettext python3-django python3-django-allauth python3-django-crispy-forms python3-docutils python3-exifread python3-pil
|
|
```
|
|
|
|
2. **Cloning.**
|
|
Change directory to where you want the project to be.
|
|
In production, we usually use `/var/www/photos/` as the `root` user.
|
|
|
|
```bash
|
|
git clone https://codeberg.org/krek0/photo21.git && cd photo21
|
|
```
|
|
|
|
3. **Configuration (production only).**
|
|
|
|
```bash
|
|
sudo mkdir static media
|
|
sudo chmod +x maintenance_tool.sh
|
|
```
|
|
|
|
4. **Database (production only).**
|
|
In development, you may use SQLite (no setup).
|
|
In production, we use PostgreSQL which require a bit of setup:
|
|
|
|
```bash
|
|
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```
|
|
|
|
|
|
6. *Enjoy \o/*
|
|
|
|
In development, you can launch the development server using:
|
|
|
|
```bash
|
|
(env)$ ./manage.py runserver
|
|
```
|