Photos

Something that tries to be a self-hosted alternative to Google Photos

Getting started

Not using docker

First, install all of the dependencies with npm i and cd frontend && npm i

You also need to create a ormconfig.json and ormconfig.test.json (only if you want to run the tests). You can use ormconfig.example.json as an example (you only need to change the database connection settings)

Using docker

Open the workspace in a remote docker container using VSCode - everything should be set up for you. You just need to rename ormconfig.dockerdevexample.json and ormconfig.dockerdevexample.test.json to ormconfig.json and ormconfig.test.json

Also, you need to run database migrations with npm run typeorm-dev -- migration:run

Then start with npm run dev and visit http://localhost:1234 (Parcel dev server is listening at http://localhost:1234, and koa at http://localhost:3000)

Actually hosting this thing

The suggested way to host this is, agian, using Docker: you can find a docker-compose example in dockercomposeexample folder

Config options

• PORT - web server port

• TYPEORM_HOST - mariadb hostname

• TYPEORM_USERNAME - mariadb username

• TYPEORM_PASSWORD - mariadb password

• TYPEORM_DATABASE - mariadb database

• TYPEORM_PORT - mariadb port

• JWT_SECRET - JWT secret - set it to something random

• HTTPS ("yes"/"no") - whether the server enforce HTTPS or not

• API_ROOT

• WEB_ROOT

Additional config options if you're not using docker

• DATA_DIR - data directory for photos and uploaded files