# nlvmi

Native Lightweight Vm Management Interface

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/>
openssl (for managing remote servers) <br/>

**Manual install:** <br/>
become root <br/>
cd /usr/local <br/>
git clone https://git.nativenet.ch/nativenet.ch/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  --or wherever your webroot is<br/> 
chown root:nlvmi nlvmi/*nlvmi <br/>
chmod +s nlvmi/wrap-nlvmi <br/>
mkdir /etc/nlvmi <br/>
cp nlvmi/vlvmi.conf /etc/nlvmi/ <br/>
-- if it is the masterserver, create the db - nlvmi createdb <br/>
chown nobody:root /etc/nlvmi <br/>

After that, you should be able to access /nlvmi with a webbrowser.
Create a new user (user will be admin) and add a server. For localhost, the connectstring should stay empty.

Do not forget to load the tun and tap kernel modules.

#not yet implemented... <br/>
mkdir /etc/nginx/nlvmi <br/>
add an "include nlvmi/*.conf" statement within nginx.conf's server declaration. <br/>