vubuntu/README.md

Ubuntu Fluxbox with NoVNC

Table of Contents :

• Packages
• Environment Variables
• Installation
• Warnings
• Desktop Environments

Packages :

• Browsers :
  • 
• Shells :
  • 
• Coding :
  • 
• Text Editors :
  • 
• Office Suite :
  • 
• Social Apps :
  • 
• Utilities :
  • 
• Languages Installed :
  • 

Environment Variables :

VNC_PASS	VNC Server Password
VNC_TITLE	VNC Session Title
VNC_RESOLUTION	VNC Server Resolution
DISPLAY	Display Server Port
PORT	NoVNC HTTP Port
NGROK_TOKEN	Ngrok Token

Installation :

• Heroku Users :
  • Fork this repo.
  • Set values for environment variables in Dockerfile (before build), do not set $PORT variable.
  • Connect your Heroku account to github via Heroku Dashboard.
  • Search for vubuntu in github repo field, connect to it.
  • Hit the Deploy Now Button.
• Non-Heroku Useers :
  • Edit & Run Command :

    docker run --name vubuntu \
    -e VNC_PASS="samplepass" \
    -e VNC_TITLE="Ubuntu_Desktop" \
    -e VNC_RESOLUTION="1280x720" \
    -e DISPLAY=:0 \
    -e PORT=9870 \
    -d -p 8080:9870 \
    vital987/vubuntu
    

[ * ] Add your private ngrok token to NGROK_TOKEN to get proper Ngrok functionality.

Warnings :

• [ ! ] $VNC_TITLE value should be without spaces.
• [ ! ] The whole project runs as a root user in a docker container.
• [ ! ] 3rd Party Softwares dosen't work with DE on Heroku(Free Plan) due to low memory.

Desktop Environments :

* MATE :

• Comment line #69 from Dockerfile
• Uncomment line #71, #72, #73 from Dockerfile
• Delete file conf.d/4-fluxbox.conf
• Copy the file extras/4-mate.conf to conf.d/

* XFCE :

• Comment line #69 from Dockerfile
• Uncomment line #75, #76 from Dockerfile
• Delete file conf.d/4-fluxbox.conf
• Copy the file extras/4-xfce.conf to conf.d/