diff --git a/.env.sample b/.env.sample
index 830b0d9..2802f18 100644
--- a/.env.sample
+++ b/.env.sample
@@ -88,7 +88,7 @@ DEFAULT_QUOTA="10 GB"
 #COMPOSE_FILE="$COMPOSE_FILE:compose.fulltextsearch.yml"
 #SECRET_ELASTICSEARCH_PASSWORD_VERSION=v1
 
-# Image / PDF previews with Imaginary
+# Image / PDF previews with Imaginary (see README)
 #COMPOSE_FILE="$COMPOSE_FILE:compose.imaginary-preview.yml"
 
 # HSTS Options
diff --git a/README.md b/README.md
index 15d619e..6ee1152 100644
--- a/README.md
+++ b/README.md
@@ -249,6 +249,20 @@ docker exec -u www-data $(docker ps -f name=foo_com_app -q) ./occ preview:pre-ge
 
 This app will improve performance of image browsing at the cost of storage space.
 
+## Better image previews with `imaginary`
+
+1. Run `abra app config <domain>` and uncomment the line `#COMPOSE_FILE="$COMPOSE_FILE:compose.imaginary-preview.yml"`.
+2. Re-deploy the app (`abra app deploy <domain> --force`)
+3. Edit `/var/www/config/config.php` and add:
+
+  ```
+  'enabledPreviewProviders' => 
+  array (
+    0 => 'OC\\Preview\\Imaginary',
+  ),
+  'preview_imaginary_url' => 'http://imaginary:9000',
+  ```
+
 ## Fulltextsearch using elasticsearch
 
 1. Uncomment the following lines in your env file: