diff --git a/README.md b/README.md
new file mode 100644
index 0000000..336478a
--- /dev/null
+++ b/README.md
@@ -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
\ No newline at end of file
diff --git a/docs/s1.png b/docs/s1.png
new file mode 100644
index 0000000..40d8a15
Binary files /dev/null and b/docs/s1.png differ