Skip to content

Commit face787

Browse files
authored
Expand upon @ichim-david's original addition
1 parent a68f9ad commit face787

File tree

1 file changed

+11
-3
lines changed

1 file changed

+11
-3
lines changed

docs/install/containers/images/backend.md

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -374,22 +374,30 @@ when Plone starts.
374374

375375
## Advanced usage
376376

377+
This section describes advanced usage of the Plone backend Docker image.
377378

378-
### Arbitrary `--user` and persisting data using `docker volumes`
379379

380-
This image supports running as a (mostly) arbitrary user via `--user` on `docker run`, as long as the owner of `/data` matches:
380+
### Arbitrary user and persistent data
381+
382+
You can run Docker as an arbitrary user with the `--user` option.
383+
384+
To persist backend data between restarts of Docker, use both options of `--user` and `-v`.
385+
386+
The following command will run the Plone backend container as an arbitrary user, and persist the backend data in a volume, provided that the owner of the directory `/data` is the same as the `--user` option.
381387

382388
```shell
383389
docker run --user="$(id -u)" -v $(pwd)/data:/data plone/plone-backend
384390
```
385391

386-
The main caveat to note is that some environment variables, such as `ADDONS` and `DEVELOP`, will not work:
392+
````{note}
393+
Some environment variables, such as `ADDONS` and `DEVELOP`, will not work.
387394

388395
```console
389396
$ docker run --user="$(id -u)" -v $(pwd)/data:/data -e ADDONS="eea.facetednavigation" plone/plone-backend
390397
...
391398
error: [Errno 13] Permission denied: '/app/lib/python3.9/site-packages/eea'
392399
```
400+
````
393401

394402

395403
### Multiple containers with ZEO

0 commit comments

Comments
 (0)