Skip to content

vtstv/novnc-install

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

17 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

noVNC + TigerVNC + XFCE4 + Nginx Reverse Proxy + HTTP Basic Auth Installer

A streamlined setup for a remote desktop environment on your Ubuntu server (and other Debian based like Kali linux).

This script combines the power of TigerVNC, noVNC, and XFCE4, with an optional, secure Nginx reverse proxy powered by Let's Encrypt SSL certificates, to create a fully functional remote desktop environment.

✨ Features

  • Effortless Installation: Automates the installation and configuration of TigerVNC, noVNC, and the lightweight XFCE4 desktop environment.
  • Secure Access: Optionally configures an Nginx reverse proxy with automatic SSL certificate generation and renewal via Let's Encrypt.
  • HTTP Basic Authentication: Provides an extra layer of security with optional HTTP Basic Authentication for your reverse proxy.
  • Customizable: Allows you to specify the VNC user, ports, display number, and hostname during setup.
  • Troubleshooting Utilities: Offers functions to help fix common Nginx configuration issues and reinstall the reverse proxy setup if needed.

πŸš€ Quick Start

git clone https://github.com/vtstv/novnc-install.git && cd novnc-install && chmod +x novnc-install.sh && sudo ./novnc-install.sh

πŸ› οΈ Usage

The script provides an interactive menu to guide you through the installation and configuration process. You can choose to:

  1. Install noVNC with TigerVNC and XFCE4.
  2. Configure an Nginx reverse proxy with Let's Encrypt SSL.
  3. Fix common Nginx configuration problems.
  4. Reinstall the Nginx reverse proxy setup.

An example of Kali linux running in the AWS cloud:

πŸ”’ Security Note

Always use strong and unique passwords for your VNC user and HTTP Basic Authentication.

🀝 Contribution

Contributions are welcome! Feel free to contribute to this project by submitting pull requests or reporting issues on the GitHub repository.

πŸ“ License

This project is licensed under the MIT License - see the LICENSE file for details.


Enjoy your new remote desktop! ✨

About

novnc-install script

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages