adds persistent guide

guides/PERSISTENT.md

@@ -0,0 +1,43 @@
+# Persistent storage
+
+## Using Services
+
+Chevereto supports using external storage providers for user provided content and website assets. It support any mixture of configurations as you may need to customize.
+
+For more information:
+
+* [External Storage](https://v3-docs.chevereto.com/features/integrations/external-storage.html) documentation
+* [Assets Variables](https://v3-docs.chevereto.com/setup/system/environment.html#assets-variables) reference
+
+## Using Volumes
+
+If you are using volumes for persistent storage, permissions in the mount path must be `www-data:www-data` to enable Chevereto to write those volumes.
+
+Run this command in the Chevereto container to set the right permissions:
+
+```sh
+/bin/bash -c 'chown -R www-data: _assets/ images/ importing/'
+```
+
+## Permissions check
+
+Enter to the container console `/bin/bash`. Once there, run `ls -la` and you should see something like this:
+
+```plain
+root@688cf7e6d94f:/var/www/html# ls -la
+total 188
+drwxrwxrwx  1 www-data www-data   4096 Jun 23 15:13 .
+drwxr-xr-x  1 root     root       4096 Jun 23 15:13 ..
+-rw-r--r--  1 www-data www-data   1310 Jun 23 15:13 .htaccess
+drwxr-xr-x  2 www-data www-data   4096 Jun 23 15:13 _assets
+drwxr-xr-x 10 www-data www-data   4096 Jun 23 15:13 app
+-rw-r--r--  1 www-data www-data    982 Jun 23 15:13 cli.php
+-rw-r--r--  1 www-data www-data   1184 Jun 23 15:13 composer.json
+-rw-r--r--  1 www-data www-data 138063 Jun 23 15:13 composer.lock
+drwxr-xr-x  4 www-data www-data   4096 Jun 23 15:13 content
+drwxr-xr-x  2 www-data www-data   4096 Jun 23 15:13 images
+drwxr-xr-x  6 www-data www-data   4096 Jun 23 16:47 importing
+-rw-r--r--  1 www-data www-data    599 Jun 23 15:13 index.php
+drwxr-xr-x  4 www-data www-data   4096 Jun 23 15:13 lib
+drwxr-xr-x  2 www-data www-data   4096 Jun 23 15:13 sdk
+```

guides/README.md

@@ -2,5 +2,6 @@
 
 For all purposes, the [docker-compose](../docker-compose/) folder contains examples on running using `docker-compose.yml` files.
 
+* [PERSISTENT](PERSISTENT.md)
 * [Portainer](portainer/README.md)
 * [Console](console/README.md)

guides/portainer/README.md

@@ -62,40 +62,8 @@ By default, Chevereto will be available at [localhost:8016](http://localhost:801
 
 When deploying for the **first time**, the volumes will be created and you will **require to fix its permissions**.
 
-## Filesystem permissions
+* Check [PERSISTENT](../PERSISTENT.md#using-volumes)
 
-Permissions in the mount path must be `www-data:www-data` to enable Chevereto to write those volumes.
-
-1. Go to your `*chv-build-*` container under **Containers**
-2. Click on **Console** then enable **Use custom command**
-3. Finish by clicking **Connect** to run (root user) the **command below**
-
-```sh
-/bin/bash -c 'chown -R www-data: _assets/ images/ importing/'
-```
-
-### Permissions check
-
-Run command `/bin/bash` (root user) and once in the container's console run `ls -la`. You should see something like this:
-
-```plain
-root@688cf7e6d94f:/var/www/html# ls -la
-total 188
-drwxrwxrwx  1 www-data www-data   4096 Jun 23 15:13 .
-drwxr-xr-x  1 root     root       4096 Jun 23 15:13 ..
--rw-r--r--  1 www-data www-data   1310 Jun 23 15:13 .htaccess
-drwxr-xr-x  2 www-data www-data   4096 Jun 23 15:13 _assets
-drwxr-xr-x 10 www-data www-data   4096 Jun 23 15:13 app
--rw-r--r--  1 www-data www-data    982 Jun 23 15:13 cli.php
--rw-r--r--  1 www-data www-data   1184 Jun 23 15:13 composer.json
--rw-r--r--  1 www-data www-data 138063 Jun 23 15:13 composer.lock
-drwxr-xr-x  4 www-data www-data   4096 Jun 23 15:13 content
-drwxr-xr-x  2 www-data www-data   4096 Jun 23 15:13 images
-drwxr-xr-x  6 www-data www-data   4096 Jun 23 16:47 importing
--rw-r--r--  1 www-data www-data    599 Jun 23 15:13 index.php
-drwxr-xr-x  4 www-data www-data   4096 Jun 23 15:13 lib
-drwxr-xr-x  2 www-data www-data   4096 Jun 23 15:13 sdk
-```
 ## Updating
 
 You will need to [update your template](../../UPDATING.md) then [re-create the build](../../BUILDING.md).