nlvmi/README.md

32 lines
1.3 KiB
Markdown
Raw Normal View History

2018-08-11 20:01:16 +02:00
# nlvmi
2018-08-11 21:41:54 +02:00
Native Lightweight Vm Management Interface
2018-08-16 18:36:53 +02:00
Nlvmi is a management interface for qemu/kvm hosts written in php (with bootstrap) and bash.<br/>
Nlvmi should be able to run on any common Linux distro without much hassle or obscure dependencies. <br/>
Nlvmi is written to be lightweight, functional and easy to understand and modify, while still looking at least acceptable on any device.<br/>
Nlvmi supports multiple users (admins and restricted) on the frontend and also uses these users to run the VMs. No PAM, just su.<br/>
Unix users have /bin/false as shell and the password is stored within the nlvmi database.<br/>
**Deps:** <br/>
bash <br/>
bridge-utils <br/>
nginx / apache / lighttpd <br/>
openssh <br/>
php <br/>
socat <br/>
sqlite3 / mariadb (only sqlite3 for now)<br/>
usermode-utilities <br/>
2018-08-11 21:41:54 +02:00
2018-08-18 16:38:57 +02:00
**Manual install:** <br/>
become root <br/>
cd /usr/local <br/>
git clone https://git.nativenet.ch/nativenet.ch/nlvmi/nlvmi.git <br/>
useradd nlvmi <br/>
ln -sf ${PWD}/nlvmi/nlvmi /usr/bin/ <br/>
ln -sf ${PWD}/nlvmi/wrap-nlvmi /usr/bin/ <br/>
ln -sf ${PWD}/nlvmi/web /var/www/localhost/htdocs/nlvmi <br/>
chown root:nlvmi nlvmi/*nlvmi <br/>
chmod +s nlvmi/wrap-nlvmi <br/>
mkdir /etc/nginx/nlvmi <br/>
add an "include nlvmi/*.conf" statement within nginx.conf's server declaration. <br/>