mirror of
https://github.com/usatiuk/photos.git
synced 2025-10-28 15:27:49 +01:00
add readme
This commit is contained in:
53
README.md
Normal file
53
README.md
Normal file
@@ -0,0 +1,53 @@
|
||||
# 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 (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
BIN
docs/s1.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 543 KiB |
Reference in New Issue
Block a user