From e6ced5de0020236c638ba1d52467fa917ea793e1 Mon Sep 17 00:00:00 2001 From: Paim pozhil Date: Sun, 31 Aug 2014 23:47:57 +0530 Subject: [PATCH] Update README.md --- README.md | 47 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 47 insertions(+) diff --git a/README.md b/README.md index 7c11060..b46f445 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,49 @@ docker-novnc ============ + +This is a minimal image which will help you run X server with openbox on the docker container and access it from ANY recent browser without requiring you to do any configuration on the client side. + + +## Use Cases + +1. Provide system application accessible over the web easily. Lets say you want to demo a software which runs on your pc over internet without requiring the clients to install any softwares like Teamviwer,etc. + +2. You can use this to create a simple use & throw linux envinronment with GUI over cloud or any VPS /Server or even at your laptop. + +Especially useful if you have to give access to your friends who come over for facebook/twittering at your PC. :) + +## How to use +``` +docker run -td -p 6080:6080 paimpozhil/docker-novnc + +#Or if you like to build yourself +git clone https://github.com/paimpozhil/docker-novnc.git +cd docker-novnc +docker built -t novnc . +docker run -td -p 6080:6080 paimpozhil/docker-novnc +``` + +Now visit + +http://kanaka.github.io/noVNC/noVNC/vnc.html +and enter + +Host as your Public IP of your docker host/server. +Post = 2222 +Leave password as blank and click connect you should see a nice display within your browser, just right click and open terminal or firefox. + + +## This is a minimal Image + +This comes only with Firefox & Geany text editor installed if you'd like to have more softwares you can freely install them using +apt-get commands + +ex: apt-get install libreoffice-base libreoffice-gtk libreoffice-calc + +## To DO +Setup a LXDE version for a more desktop like setup +Add Authentication for VNC. + +## Credits + +#### NoVNC http://kanaka.github.io/noVNC/