This repository has been archived on 2022-06-22. You can view files and clone it, but cannot push or open issues or pull requests.
Plasma-in-Arch-in-Docker/README.md

114 lines
2 KiB
Markdown
Raw Normal View History

2020-02-02 05:20:10 +00:00
# docker-ubuntu-vnc
2020-02-02 13:54:07 +00:00
[![Docker Cloud Build Status](https://img.shields.io/docker/cloud/build/dcsunset/ubuntu-vnc)](https://hub.docker.com/r/dcsunset/ubuntu-vnc)
[![Docker Image Size](https://badgen.net/docker/size/dcsunset/ubuntu-vnc)](https://hub.docker.com/r/dcsunset/ubuntu-vnc)
A docker image of Ubuntu with Xfce desktop and VNC support.
2020-02-02 05:20:10 +00:00
2020-02-04 02:39:37 +00:00
## Screenshots
![Figure 1](./screenshots/1.png)
![Figure 2](./screenshots/2.png)
2020-02-03 07:33:11 +00:00
## Tags
Different tags of this image are based on different versions of ubuntu.
Currently available tags:
* latest: based on ubuntu:lastest
* 18.04: based on ubuntu:18.04
* 16.04: based on ubuntu:16.04
2020-02-05 08:06:38 +00:00
## Pull image
```
docker pull dcsunset/ubuntu-vnc:<tag>
```
The tag can be one of those listed above.
2020-02-02 05:20:10 +00:00
## Usage
2020-02-02 12:03:49 +00:00
Simple usage:
2020-02-02 05:20:10 +00:00
```
2020-02-02 12:03:49 +00:00
docker run -d -p 5900:5900 -p 6080:6080 -e VNC_PASSWD=password dcsunset/ubuntu-vnc
2020-02-02 05:20:10 +00:00
```
2020-02-05 08:06:38 +00:00
Then visit <http://localhost:6080> to visit noVNC UI.
2020-02-02 12:03:49 +00:00
Or you can use a different VNC client (like TigerVNC client)
and connect to localhost:5900.
2020-02-02 05:20:10 +00:00
If `VNC_PASSWD` is not set,
then the security type of vncserver is set to None,
it is **insecure** when exposing the container on the Internet.
## Exposed ports
* 5900: Used for VNC interface
2020-02-02 11:58:03 +00:00
* 6080: Used for noVNC Web UI
2020-02-02 05:20:10 +00:00
## Installed applications
To make the image lightweight,
only the following applications are installed by default:
* Xfce desktop
* TigerVNC server
2020-02-02 12:03:49 +00:00
* noVNC
2020-02-02 13:54:07 +00:00
* wget
2020-02-03 07:33:11 +00:00
* Python3
2020-02-02 05:20:10 +00:00
* Vim
* Chromium browser
2020-02-02 11:58:03 +00:00
## Build
2020-02-02 05:20:10 +00:00
2020-02-02 11:58:03 +00:00
To use the latest Ubuntu image:
2020-02-02 05:20:10 +00:00
```
2020-02-02 11:58:03 +00:00
docker build -t ubuntu-vnc .
2020-02-02 05:20:10 +00:00
```
2020-02-02 11:58:03 +00:00
Or specify a version:
2020-02-02 05:20:10 +00:00
```
2020-02-02 11:58:03 +00:00
docker build --build-arg VERSION=18.04 -t ubuntu-vnc .
2020-02-02 05:20:10 +00:00
```
2020-02-02 11:58:03 +00:00
## FAQ
### Fonts
If non-latin characters are not displayed well,
install the font packs based on your needs.
To install the Indian font pack:
2020-02-02 05:20:10 +00:00
```
2020-02-02 11:58:03 +00:00
apt-get install fonts-indic
2020-02-02 05:20:10 +00:00
```
2020-02-02 11:58:03 +00:00
To install the CJK font pack:
2020-02-02 05:20:10 +00:00
```
2020-02-02 11:58:03 +00:00
apt-get install fonts-noto-cjk
2020-02-02 05:20:10 +00:00
```
2020-02-02 11:58:03 +00:00
To install the international font pack:
2020-02-02 05:20:10 +00:00
```
2020-02-02 11:58:03 +00:00
apt-get install fonts-noto
2020-02-02 05:20:10 +00:00
```
2020-02-02 11:58:03 +00:00
### Scaling
By default, noVNC's scaling mode is set to None.
It can be changed in the noVNC panel easily.
2020-02-02 12:08:33 +00:00
## License
2020-02-02 12:08:33 +00:00
MIT License