diff --git a/README.md b/README.md
index 973121418f6d3c7a31bb8792b81d9f0ef8f65f9f..e8047c31489becccdb6e6a1026854bf0aa2a1cf5 100644
--- a/README.md
+++ b/README.md
@@ -64,7 +64,7 @@ Image                | Task
 ## Other documentation
 
 * [Development](development.md)
-* [Scripts](scripts.md) (TODO)
+* [Scripts](scripts.md)
 * [Packages](packages.md) (TODO)
 
 ## License
diff --git a/scripts.md b/scripts.md
new file mode 100644
index 0000000000000000000000000000000000000000..2fff80473b291e14bc8b58d75a87fa61c6940225
--- /dev/null
+++ b/scripts.md
@@ -0,0 +1,27 @@
+Scripts
+=======
+
+## Upload
+
+### Examples
+
+```
+export APTLY_SERVER=http://172.17.0.1:8080/api
+export APTLY_USERNAME=icingaadmin
+export APTLY_PASSWORD=icinga
+
+# automatic repo name in aptly
+icinga-build-upload-aptly --target debian --release icinga-stretch
+
+# staying conform with old repo names
+icinga-build-upload-aptly --target debian --release icinga-stretch-snapshots --repo icinga-raspbian-stretch-snapshot
+icinga-build-upload-aptly --target debian --release icinga-stretch --repo icinga-raspbian-stretch-release
+
+# architectures, e.g. for raspbian
+icinga-build-upload-aptly --target raspbian \
+  --release icinga-stretch --repo icinga-raspbian-stretch-release --architectures armhf
+
+# for rpms
+icinga-build-upload-aptly --target epel --release 7/release
+icinga-build-upload-aptly --target epel --release 7/snapshot
+```