{"id":27004518,"url":"https://github.com/tacc/docker-ubuntu-vnc-desktop-application-base","last_synced_at":"2025-04-04T06:17:03.942Z","repository":{"id":39360000,"uuid":"213496445","full_name":"TACC/docker-ubuntu-vnc-desktop-application-base","owner":"TACC","description":null,"archived":false,"fork":false,"pushed_at":"2022-12-10T06:36:07.000Z","size":13256,"stargazers_count":1,"open_issues_count":25,"forks_count":2,"subscribers_count":7,"default_branch":"generic-portal-vnc","last_synced_at":"2024-04-16T02:11:41.283Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TACC.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-10-07T22:11:38.000Z","updated_at":"2024-04-16T02:11:41.284Z","dependencies_parsed_at":"2022-08-25T17:21:25.042Z","dependency_job_id":null,"html_url":"https://github.com/TACC/docker-ubuntu-vnc-desktop-application-base","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TACC%2Fdocker-ubuntu-vnc-desktop-application-base","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TACC%2Fdocker-ubuntu-vnc-desktop-application-base/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TACC%2Fdocker-ubuntu-vnc-desktop-application-base/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TACC%2Fdocker-ubuntu-vnc-desktop-application-base/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TACC","download_url":"https://codeload.github.com/TACC/docker-ubuntu-vnc-desktop-application-base/tar.gz/refs/heads/generic-portal-vnc","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247128737,"owners_count":20888235,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-04-04T06:17:03.338Z","updated_at":"2025-04-04T06:17:03.925Z","avatar_url":"https://github.com/TACC.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"docker-ubuntu-vnc-desktop\n=========================\n\n[![Docker Pulls](https://img.shields.io/docker/pulls/dorowu/ubuntu-desktop-lxde-vnc.svg)](https://hub.docker.com/r/dorowu/ubuntu-desktop-lxde-vnc/)\n[![Docker Stars](https://img.shields.io/docker/stars/dorowu/ubuntu-desktop-lxde-vnc.svg)](https://hub.docker.com/r/dorowu/ubuntu-desktop-lxde-vnc/)\n\nDocker image to provide HTML5 VNC interface to access Ubuntu 16.04 LXDE desktop environment.\n\nQuick Start\n-------------------------\n\nRun the docker container and access with port `6080`\n\n```\ndocker run -p 6080:80 -v /dev/shm:/dev/shm dorowu/ubuntu-desktop-lxde-vnc\n```\n\nBrowse http://127.0.0.1:6080/\n\n\u003cimg src=\"https://raw.github.com/fcwu/docker-ubuntu-vnc-desktop/master/screenshots/lxde.png?v1\" width=700/\u003e\n\n**Ubuntu Version**\n\nChoose your favorite Ubuntu version with [tags](https://hub.docker.com/r/dorowu/ubuntu-desktop-lxde-vnc/tags/)\n\n- bionic: Ubuntu 18.04 (latest)\n- bionic-lxqt: Ubuntu 18.04 LXQt\n- xenial: Ubuntu 16.04\n- trusty: Ubuntu 14.04\n\nVNC Viewer\n------------------\n\nForward VNC service port 5900 to host by\n\n```\ndocker run -p 6080:80 -p 5900:5900 -v /dev/shm:/dev/shm dorowu/ubuntu-desktop-lxde-vnc\n```\n\nNow, open the vnc viewer and connect to port 5900. If you would like to protect vnc service by password, set environment variable `VNC_PASSWORD`, for example\n\n```\ndocker run -p 6080:80 -p 5900:5900 -e VNC_PASSWORD=mypassword -v /dev/shm:/dev/shm dorowu/ubuntu-desktop-lxde-vnc\n```\n\nA prompt will ask password either in the browser or vnc viewer.\n\nHTTP Base Authentication\n---------------------------\n\nThis image provides base access authentication of HTTP via `HTTP_PASSWORD`\n\n```\ndocker run -p 6080:80 -e HTTP_PASSWORD=mypassword -v /dev/shm:/dev/shm dorowu/ubuntu-desktop-lxde-vnc\n```\n\nSSL\n--------------------\n\nTo connect with SSL, generate self signed SSL certificate first if you don't have it\n\n```\nmkdir -p ssl\nopenssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout ssl/nginx.key -out ssl/nginx.crt\n```\n\nSpecify SSL port by `SSL_PORT`, certificate path to `/etc/nginx/ssl`, and forward it to 6081\n\n```\ndocker run -p 6081:443 -e SSL_PORT=443 -v ${PWD}/ssl:/etc/nginx/ssl -v /dev/shm:/dev/shm dorowu/ubuntu-desktop-lxde-vnc\n```\n\nScreen Resolution\n------------------\n\nThe Resolution of virtual desktop adapts browser window size when first connecting the server. You may choose a fixed resolution by passing `RESOLUTION` environment variable, for example\n\n```\ndocker run -p 6080:80 -e RESOLUTION=1920x1080 -v /dev/shm:/dev/shm dorowu/ubuntu-desktop-lxde-vnc\n```\n\nDefault Desktop User\n--------------------\n\nThe default user is `root`. You may change the user and password respectively by `USER` and `PASSWORD` environment variable, for example,\n\n```\ndocker run -p 6080:80 -e USER=doro -e PASSWORD=password -v /dev/shm:/dev/shm dorowu/ubuntu-desktop-lxde-vnc\n```\n\nDeploy to a subdirectory (relative url root)\n--------------------------------------------\n\nYou may deploy this application to a subdirectory, for example `/some-prefix/`. You then can access application by `http://127.0.0.1:6080/some-prefix/`. This can be specified using the `RELATIVE_URL_ROOT` configuration option like this\n\n```\ndocker run -p 6080:80 -e RELATIVE_URL_ROOT=some-prefix dorowu/ubuntu-desktop-lxde-vnc\n```\n\nNOTE: this variable should not have any leading and trailing splash (/)\n\nSound (Preview version and Linux only)\n--------------------------------------\n\nIt only works in Linux. \n\nFirst of all, insert kernel module `snd-aloop` and specify `2` as the index of sound loop device\n\n```\nsudo modprobe snd-aloop index=2\n```\n\nStart the container\n\n```\ndocker run -it --rm -p 6080:80 --device /dev/snd -e ALSADEV=hw:2,0 dorowu/ubuntu-desktop-lxde-vnc\n```\n\nwhere `--device /dev/snd -e ALSADEV=hw:2,0` means to grant sound device to container and set basic ASLA config to use card 2.\n\nLaunch a browser with URL http://127.0.0.1:6080/#/?video, where `video` means to start with video mode. Now you can start Chromium in start menu (Internet -\u003e Chromium Web Browser Sound) and try to play some video.\n\nFollowing is the screen capture of these operations. Turn on your sound at the end of video!\n\n[![demo video](http://img.youtube.com/vi/Kv9FGClP1-k/0.jpg)](http://www.youtube.com/watch?v=Kv9FGClP1-k)\n\n\nGenerate Dockerfile from jinja template\n-------------------\n\nDockerfile and configuration can be generated by template. \n\n- arch: one of `amd64` or `armhf`\n- flavor: refer to file in flavor/`flavor`.yml\n- image: base image\n- desktop: desktop environment which is set in flavor\n- addon_package: Debian package to be installed which is set in flavor\n\nDockerfile and configuration are re-generate if they do not exist. Or you may force to re-generate by removing them with the command `make clean`.\n\nTroubleshooting and FAQ\n==================\n\n1. boot2docker connection issue, https://github.com/fcwu/docker-ubuntu-vnc-desktop/issues/2\n2. Multi-language supports, https://github.com/fcwu/docker-ubuntu-vnc-desktop/issues/80\n3. Autostart, https://github.com/fcwu/docker-ubuntu-vnc-desktop/issues/85\n4. x11vnc arguments(multiptr), https://github.com/fcwu/docker-ubuntu-vnc-desktop/issues/101\n5. firefox/chrome crash (/dev/shm), https://github.com/fcwu/docker-ubuntu-vnc-desktop/issues/112\n6. resize display size without destroying container, https://github.com/fcwu/docker-ubuntu-vnc-desktop/issues/115#issuecomment-522426037\n\nLicense\n==================\n\nSee the LICENSE file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftacc%2Fdocker-ubuntu-vnc-desktop-application-base","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftacc%2Fdocker-ubuntu-vnc-desktop-application-base","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftacc%2Fdocker-ubuntu-vnc-desktop-application-base/lists"}