Web UI for ProxmoxAAS
Go to file
Arthur Lu 08dcc8bcdf improve some styling
Signed-off-by: Arthur Lu <learthurgo@gmail.com>
2023-04-06 19:47:40 +00:00
css improve some styling 2023-04-06 19:47:40 +00:00
images fix remaining icons 2023-04-03 21:17:18 +00:00
scripts improve some styling 2023-04-06 19:47:40 +00:00
.gitignore add template file for vars.js 2023-01-20 04:58:33 +00:00
account.html simplify styling 2023-04-06 03:46:39 +00:00
config.html improve some styling 2023-04-06 19:47:40 +00:00
index.html improve font size scaling 2023-04-06 04:43:36 +00:00
login.html simplify styling 2023-04-06 03:46:39 +00:00
README.md Update README.md 2023-02-28 21:09:12 -08:00
vars.js.template use client api endpont for proxmox requests 2023-02-24 22:25:36 +00:00

ProxmoxAAS Client - Proxmox As A Service User Interface

ProxmoxAAS Client provides users of a proxmox based compute on demand service a simplified UI which gives users power management, console access, and instance configuration utility. It also allows administrators to set resource quotas for users and allows users to configure instances without administrator priviledges.

Features

  • Simplified interface for clients
  • Instance power management
  • Instance resource configuration
  • Instance creation and destruction
  • Remote console
  • Basic account management

Prerequisites

  • Proxmox VE Cluster (v7.0+)
  • Reverse proxy server which serves the Proxmox VE Web GUI & API (ie nginx)
  • Web server to host the ProxmoxAAS Client (ie Apache2)

Notes

The supported setup is to use a reverse proxy to serve both the original Proxmox web interface and ProxmoxAAS Client. It is possible other setups can work. Rather than provide specific steps to duplicate a certain setup, the steps included are intended as a guideline of steps required for proper function in most setups. Consequently, the examples provided are only to highlight key settings and do not represent complete working configurations. The instructions also assume you have your own domain name which will substitute <FQDN> in some of the configs.

Installation - Client

  1. Install Apache2 or another HTTP server onto a container or vm, which will be Client Host
  2. Clone this repo onto Client Host, the default location for web root is /var/www/html/
  3. Configure Apache2 to serve the Client at port 80 by adding the file client.conf to /etc/apache2/sites-avaliable/ with at least the following:
<VirtualHost *:80>
	DocumentRoot /var/www/html/ProxmoxAAS-Client/
</VirtualHost>
  1. Enable the Client site by running a2ensite client

After this step, the Client should be available on the Client Host at port 80

Installation - Reverse Proxy

  1. Configure nginx or preferred reverse proxy service to reverse proxy the default Proxmox web UI hosted by Proxmox Host:
server {
	listen 443 ssl;
	server_name pve.<FQDN>;
	location / {
		proxy_pass https://<Proxmox Host>:8006;
    	}
}
  1. Configure nginx to reverse proxy the client. This can be done in the same file previously or in a new configuration file:
server {
	listen 443 ssl;
	server_name client.<FQDN>;
	location / {
		proxy_pass http://<Client Host>:80;
	}
	location /api/ {
		proxy_pass http://<Client Host>:8080;
	}
}
  1. Restart nginx with the new configurations by running systemctl restart nginx

Installation - Client Configuration

  1. In the Client Host, navigate to the repo root folder, rename vars.js.template to vars.js and modify API withe the value client.<FQDN>/api

API Installation

To install the API, go to ProxmoxAAS API. This is required for the client to function.