tronnet/ProxmoxAAS-Dashboard
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Web UI for ProxmoxAAS
562 Commits 2 Branches 0 Tags 1.3 MiB
JavaScript 62.5%
CSS 25.2%
HTML 12.3%
e97f8d5bbc
Go to file
Arthur Lu e97f8d5bbc fix bugs in network config change, 
generalize dialog layout,
add form validation callback,
add password change form
2023-11-14 00:09:41 +00:00
css add password form to account, 2023-10-31 18:13:40 +00:00
images add visual highlight to matching search query substrings, 2023-09-20 22:17:06 +00:00
scripts fix bugs in network config change, 2023-11-14 00:09:41 +00:00
.eslintrc.json add js linting, fix js linting issues 2023-06-29 22:20:15 +00:00
.gitignore add js linting, fix js linting issues 2023-06-29 22:20:15 +00:00
.stylelintrc.json add css linting, fix css linting issues 2023-06-29 22:39:21 +00:00
account.html fix bugs in network config change, 2023-11-14 00:09:41 +00:00
config.html add bottom padding to main, 2023-10-18 19:33:58 +00:00
index.html add bottom padding to main, 2023-10-18 19:33:58 +00:00
login.html add local copy of w3.css fallback, 2023-10-12 17:27:37 +00:00
package.json finish renaming, 2023-09-15 22:13:21 +00:00
README.md add local copy of w3.css fallback, 2023-10-12 17:27:37 +00:00
settings.html fix nav styling, 2023-10-19 17:26:37 +00:00
template.vars.js add local copy of w3.css fallback, 2023-10-12 17:27:37 +00:00
w3.css add local copy of w3.css fallback, 2023-10-12 17:27:37 +00:00

README.md

ProxmoxAAS Dashboard - Proxmox As A Service User Web Interface

ProxmoxAAS Dashboard 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 non administrator users
  • Instance power management
  • Instance resource configuration
  • Instance creation and destruction
  • Remote console
  • Extended account management

Prerequisites

  • Proxmox VE Cluster (v7.0+)
  • Reverse proxy server which can proxy the dashboard and API
    • FQDN
  • Web server to host the ProxmoxAAS Dashboard (ie Apache2)

Notes

The supported setup is to use a reverse proxy to serve both the original Proxmox web interface and ProxmoxAAS Dashboard. 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 - Dashboard

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

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

Configuration - Dashboard

  1. In Dashboard Host, navigate to this repo's root folder
  2. Rename template.vars.js to vars.js and assign the API variable with the value of the API's URL. This will likely be paas.<FQDN>/api

Installation - API

To install the API, go to ProxmoxAAS API. This is required for the app to function. The API installation will also have steps for setting up the reverse proxy server.