diff --git a/README.md b/README.md
index 04af39d..5cac18f 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,17 @@ A minimal HTTP server for hosting an OSTree/Flatpak repository, written in Rust
 
 Includes a non-standard route for uploading flatpak bundles:
 
-    curl -v -XPOST -T ./org.example.Example.aarch64.flatpak http://localhost:3000/flatpak-bundle/upload
+    curl -v -XPOST -T \
+        ./org.example.Example.aarch64.flatpak \
+        http://localhost:3000/flatpak-bundle/upload?key=<api-key>
+
+Set the api key using `FR_API_KEY=<api-key>`.
+
+See `flatpak-repo --help` for a full list of env/cli arguments.
+
+## Building
+
+    docker build . -t flatpak-repo
 
 ## Missing features
 
@@ -14,8 +24,15 @@ flatpak-repo does not generate an ostree folder for you. Create one like this:
 
 flatpak-repo does not generate gpg keys for you.
 
-flatpak-repo does not generate a `flatpakrepo` file for you, but expects one to be places in the repo folder.
+flatpak-repo does not generate a `flatpakrepo` file for you, but expects one to be placed in the repo folder root.
 
-add the flatpak remo like this:
+Example `flatpakremote`:
+
+    [Flatpak Repo]
+    Title=example.com
+    Url=https://flatpak-repo.example.com
+    GPGKey=<base64-encoded gpg public key>
+
+add the flatpak remote like this:
 
     sudo flatpak remote-add --from <name> https://<url>/flatpakrepo