vubuntu/README.md

Ubuntu Fluxbox with NoVNC

[ ! ] Using VNC/Remote Desktops are strictly prohibited/banned on many free PaaS platforms.
[ ! ] Deploy/Use at your own risk & responsibility!

Table of Contents :

• Packages
• Screenshots
• Environment Variables
• Installation
• Warnings

Packages :

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

Screenshots :

Laptop/Desktop

Smartphone/Tablet

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 :
  • Click on Deploy Now](https://heroku.com/deploy?template=https://github.com/vubuntu) button.
  • Set the repo name & variables.
  • Deploy.
  • [ ! ] The project takes a minute or two to load on Railway after the deployment, till that it will show 404 error, be patient.
• Manual Method :
  • 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.
• [ ! ] $VNC_PASS value should be without spaces.
• [ ! ] The project takes a minute or two to load on Railway after the deployment, till that it will show 404 error, be patient.
• [ ! ] The whole project runs as a root user in a docker container.