OpenEcoLab-LasAlpujarras
/
farmOS
mirror of https://github.com/farmOS/farmOS.git
3
0
Fork 0
Code Wiki

Update docker file permission documentation 

* Why? Explain new default user/group id and
  the option to build a custom dev docker image.
  This change goes along with https://github.com/farmOS/farmOS/pull/384
This commit is contained in:
Symbioquine 2020-12-24 09:06:41 -08:00 committed by Michael Stenta
parent 23685359e9
commit 9050872223
1 changed files with 29 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
docs/development/docker.md
View File

@ -122,9 +122,23 @@ destroyed and rebuilt.
### File ownership
On a Linux host, all the files in `www` will have an owner and group of
`www-data`. For development purposes, it is recommended that you change the
owner of everything in the `www` container to your local user. This can be done
with the following command:
`www-data`. As of farmOS 7.x-1.7 the `www-data` user and group id of the dev docker
image are set to `1000` by default. On most single-user systems this matches the
user and group ID of the primary user and everything should just work - the docker
container and your user will both have normal read/write access to the files.
If you encounter permissions issues, you can check your user/group ids with the
following commands;
id -u
id -g
If those don't return a value of `1000`, there are two main strategies.
#### One-off ownership modification
You can change the owner of everything in the `www` container to your local user.
This can be done with the following command:
sudo chown -R ${USER} www
@ -132,6 +146,18 @@ This changes the owner of *everything* in /var/www/html to the currently logged
in user on the host. But it leaves the group alone (`www-data`). Just make sure
to do this _after_ installation has completed.
#### Building a custom dev docker image
The dev image also accepts the `WWW_DATA_ID` build parameter which the build
process will use as the ID of the www-data user and group inside the image.
Setting this to the ID of the developer's user on the host machine allows files
created and/or owned by www-data inside the container be editable by the developer
outside of the container.
If your user ID is not `1000` (as determined above), build the image with:
`--build-arg WWW_DATA_ID=$(id -u)`.
## Updating farmOS
**Important**: these instructions are for updating a *development* environment