add readme

This commit is contained in:
2020-10-23 11:06:30 +03:00
committed by Stepan Usatiuk
parent 88a9d5bce3
commit 08c83e7284
2 changed files with 53 additions and 0 deletions

53
README.md Normal file
View File

@@ -0,0 +1,53 @@
# Photos
Something that tries to be a self-hosted alternative to Google Photos
![screenshot](docs/s1.png)
## 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 (for docker container)
* `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
### Config options (the rest of them)
* `DATA_DIR` - data directory for photos and uploaded files

BIN
docs/s1.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 543 KiB