39 lines
1.4 KiB
Markdown
39 lines
1.4 KiB
Markdown
# Xubuntu on Docker
|
|
|
|
A Docker image based on Ubuntu 20.04 with the Xfce desktop environment,
|
|
[XRDP](https://github.com/neutrinolabs/xrdp),
|
|
[XRDP PulseAudio module](https://github.com/neutrinolabs/pulseaudio-module-xrdp) and
|
|
[VirtualGL](https://github.com/VirtualGL/virtualgl).
|
|
|
|
## Start an instance
|
|
|
|
```sh
|
|
docker run \
|
|
--name xubuntu \
|
|
--detach \
|
|
--shm-size 2g \
|
|
--publish 3322:3322/tcp \
|
|
--publish 3389:3389/tcp \
|
|
--device /dev/dri:/dev/dri \
|
|
hectormolinero/xubuntu:latest
|
|
```
|
|
|
|
> You will be able to connect to the container via SSH through 3322/tcp port and RDP through 3389/tcp port.
|
|
|
|
> **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`: comma-separated list of additional GIDs for the unprivileged user (none by default).
|
|
* `UNPRIVILEGED_USER_SHELL`: unprivileged user shell (`/bin/bash` by default).
|
|
* `ENABLE_XDUMMY`: enable an X dummy server (`false` by default and requires the `--privileged` option).
|
|
|
|
## License
|
|
|
|
See the [license](LICENSE.md) file.
|