Files
docker-xubuntu/README.md
Héctor Molinero Fernández 876508cd9c Dynamically create unprivileged user
2019-07-07 20:01:51 +02:00

38 lines
1.4 KiB
Markdown

# Xubuntu on Docker
A Docker image based on Ubuntu 18.04 with Xfce desktop environment,
[VirtualGL](https://github.com/VirtualGL/virtualgl),
[XRDP](https://github.com/neutrinolabs/xrdp) and
[XRDP PulseAudio module](https://github.com/neutrinolabs/pulseaudio-module-xrdp).
## Start an instance
```sh
docker run --detach \
--name xubuntu \
--publish 3389:3389/tcp \
hectormolinero/xubuntu:latest
```
> You will be able to connect to the container via RDP through 3389/tcp port.
> **Important:** if you use the `--privileged` option the container will be able to use the GPU with
VirtualGL, but this will conflict with the host X server.
> **Important:** some software (like Firefox) need the shared memory to be increased, if you
encounter any problem related to this you may use the `--shm-size` option.
## Environment variables
* `UNPRIVILEGED_USER_UID`: unprivileged user UID (`1000` by default).
* `UNPRIVILEGED_USER_GID`: unprivileged user GID (`1000` by default).
* `UNPRIVILEGED_USER_NAME`: unprivileged user name (`guest` by default).
* `UNPRIVILEGED_USER_PASSWORD`: unprivileged user password (`password` by default).
* `UNPRIVILEGED_USER_GROUPS`: unprivileged user groups (`audio,input,video` by default).
* `UNPRIVILEGED_USER_SHELL`: unprivileged user shell (`/bin/bash` by default).
* `DISABLE_GPU`: disable the GPU in the container (`false` by default).
## License
See the [license](LICENSE.md) file.