LXC-Web-Panel is an easy to use Linux Containers manager.
- NEW Installer to make it even easier to start running.
- Display some host and container information: IP, CPU, Mem and Disk usage.
- List, create, delete containers and change container settings.
- Start, stop and freeze containers
- Create container backup to a tar.gz
- List, create and delete snapshots
- Show system compatibility
- Manage panel users
- Expose container operations through a REST API and Manage API authoritation tokens
This is a fork of the original LXC-Web-Panel from https://github.com/lxc-webpanel/LXC-Web-Panel and https://github.com/claudyus/LXC-Web-Panel/ looking for LXC 2.x compatibility, Python 3, UI updating, New features like snapshots and backup restore management, and Fabric (fabfile) integration to be able to manage remote hosts.
Some features from Claudyus may fell off like Filebucket backups (not updated since 2015), probably LDAP integration (as we have no means to test it), and some more.
If you use this fork please ensure to use at least lxc 2.0.7. The code was tested on Debian 9.5 Stretch.
We are working on this heavily so expect frequent changes in code, installation docs outdated, ...
All contributions are welcomed.
If you want to run lwp from source code:
mkdir gantry && cd gantry python3 -m venv gantryenv source gantryenv/bin/activate git clone https://github.com/EstudioNexos/LXC-Web-Panel.git cd LXC-Web-Panel pip install cryptography # installing pyopenssl fails if cryptography is not already installed python setup.py install ./bin/lwp # run lwp wth debug support
We recomend using /var/lpw/backups or /var/backups/lxc path.
First run we will get an installer page, most of defaults are OK and just click INSTALL.
Then stop lwp and start it again.
Default login is admin/admin but soon it will be configurable through the installer.
Your lwp panel is now at http://localhost:5000/.
To enable authentication against htpasswd file you should set auth type to htpasswd and file variable in htpasswd section to point to the htpasswd file.
This backend use the crypt function, here an example where -d force the use of crypt encryption when generating the htpasswd file:
htpasswd -d -b -c /etc/lwp/httpasswd admin admin
To enable authentication against PAM you should set auth type to pam and service variable in pam section.
Python PAM module needs to be installed:
apt-get install python-pam
or
pip install pam
or
yum install python-pam
With default login service all valid linux users can login to lwp.
Many more options are available via PAM Configuration, see PAM docs.
This auth method is used to authenticate the users using an external http server through a POST request. To enable this method auth type to http and configure the option under http section.
If you want to use different type of authentication, create appropriate file in authenticators/ directory with specific structure (example can be viewed in stub authenticator)
After a fresh git clone you should download the bower component and setup the package for development purpose.
fab build_assets sudo ./setup.py develop cp lwp.example.conf lwp.conf
Now you can run lwp locally using sudo ./bin/lwp --debug
Debug is just one of the available options to profile lwp you can use --profiling options, those options can also be
used against the global installation using: sudo lwp --debug
Anyway ensure to stop the lwp service if any: sudo service lwp stop
To run test locally unsure that mock-lxc scripts are in PATH (export PATH=`pwd`/tests/mock-lxc:$PATH) than run fab dev_test
To build a local debian package run fab debian
This work is released under MIT License, see LICENSE file.