Repository files navigation

A simple web interface based onlibVirt andnodejs.

This project is still aWork In Progress, it might not work correctly on your side.

Please, create an issue in this case so I can track and fix it.

Thank you.

If you were looking for aPHP version:https://github.com/Jiab77/libvirt-web.

Images will be added soon.

The installation process is pretty simple and will require only few dependencies.

The web interface should be able to run on desktops and servers.

There is only few dependencies required:

1. libvirt-bin (Thevirsh command should be provided bylibVirt)
2. virt-viewer
3. libguestfs
4. nodejs
5. npm

I have dropped the ImageMagickconvert command from dependencies.

The project has been tested onPop_OS!, a Linux distribution based onUbuntu 18.04 LTS.

You should only need to install these packages:

# Install dependencies (desktop)sudo apt install libvirt-bin virt-viewer libguestfs-tools nodejs npm# Install dependencies (server)sudo apt install libvirt-bin libguestfs-tools nodejs npm# Install nodejs modulesgit clone https://github.com/Jiab77/libvirt-web-nodejs.gitcd libvirt-web-nodejsnpm install

I still need to validate the packages list so this might change later.

You can run the web interface by using the embedded web server fromnodejs or usingapache ornginx.

You can start the server that way:

cd libvirt-web-nodejsnode server.js

To configure the server:

• Define theLIBVIRT_WEB_HOST to change the listening address.
• Define theLIBVIRT_WEB_PORT to change the listening port.

sudo is not required to run the server. It is required only if you want to run the server on a port below1024.

You can also choose any other ports than8001.

Then navigate tohttp://localhost:8001 with your internet browser.

I'm using Chromium but it should work on any other modern browser.

This setup is not tested yet and will be documented later.

Here will be listed missing features / those not working correctly.

• Remote connection on VM's usingvirt-viewer.
  • Works on local only...
• Connection to remote hypervisor.
  • Not implemented yet / not correctly...
• ISO image upload.
  • The upload is working but the uploaded file can't be moved to/var/lib/libvirt/images...
  • This is due to access restricted tosudoers with filesystem permissions.
• Graphics are still missing.

Thanks to the respective developers for their amazing work.

Huge thanks to@baslr for thenode-ppm-bin module.

Feel free to contribute by creating pull requests or new issues.

You can reach me on Twitter by using@jiab77.