diff --git a/guides/portainer.md b/guides/portainer/README.md
similarity index 88%
rename from guides/portainer.md
rename to guides/portainer/README.md
index f23b95c..da155c9 100644
--- a/guides/portainer.md
+++ b/guides/portainer/README.md
@@ -2,7 +2,7 @@
 
 ## Requirements
 
-To use Chevereto with [Portainer](https://www.portainer.io/) you need the Chevereto image build already made and available in the private container registry of your choice.
+To use Chevereto with [Portainer](https://www.portainer.io/) you need the **Chevereto image build** already made and available in the private container registry of your choice.
 
 ## Installation
 
@@ -12,7 +12,7 @@ To use Chevereto with [Portainer](https://www.portainer.io/) you need the Chever
 
 ## docker-compose
 
-Build your own `docker-compose` file by grabbing [httpd-php.dist.yml](../docker-compose/httpd-php.dist.yml) and change:
+Build your own `docker-compose` file by grabbing [httpd-php.dist.yml](./httpd-php.dist.yml) and change:
 
 ```yml
   chv-build:
@@ -26,6 +26,8 @@ To this, where `your_image_here` references your private image tag.
     image: your_image_here
 ```
 
+You may alter the default provisioning to change HTTPS behavior, set a external storage provider for assets, etc. By default this guide only uses local volumes.
+
 ## Adding Chevereto as a Portainer custom application
 
 1. Open Portainer and go to endpoint **Dashboard**
@@ -109,9 +111,9 @@ CHEVERETO_ASSET_STORAGE_URL: http://localhost:8016/_assets/
 
 ## Updating
 
-You will need to [update your container image](../README.md#updating) then re-create the new image build.
+You will need to [update your template](../../UPDATING.md) then [re-create the build](../../BUILDING.md).
 
-Once the container image gets re-build, you can re-create the container:
+Once the container image gets re-build, you can re-create the container in Portainer:
 
 1. Go to your `*chv-build-*` container and click on **Recreate**
 2. Make sure to enable **Pull latest image**
@@ -125,6 +127,8 @@ The container will be re-created with the updated application layer. Data in you
 
 ## Volume reference
 
+In this Portainer guide persisten storage is provided using volumes. This volume reference is just for purposes of this Portainer guide.
+
 | Volume      | Mount path             | Purpose                              |
 | ----------- | ---------------------- | ------------------------------------ |
 | chv-storage | /var/www/html/images/  | User uploads                         |
diff --git a/docker-compose/httpd-php.dist.yml b/guides/portainer/httpd-php.dist.yml
similarity index 100%
rename from docker-compose/httpd-php.dist.yml
rename to guides/portainer/httpd-php.dist.yml