{"id":20024738,"url":"https://github.com/claudyus/lxc-web-panel","last_synced_at":"2025-07-27T16:10:27.098Z","repository":{"id":15870524,"uuid":"18611232","full_name":"claudyus/LXC-Web-Panel","owner":"claudyus","description":"LXC Web Panel improved for lxc 1.0+","archived":false,"fork":false,"pushed_at":"2017-11-28T13:10:00.000Z","size":10558,"stargazers_count":221,"open_issues_count":36,"forks_count":68,"subscribers_count":30,"default_branch":"master","last_synced_at":"2024-12-06T10:12:20.670Z","etag":null,"topics":["interface","lxc","python"],"latest_commit_sha":null,"homepage":"http://claudyus.github.io/LXC-Web-Panel/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/claudyus.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG.rst","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-04-09T20:04:24.000Z","updated_at":"2024-08-29T06:58:44.000Z","dependencies_parsed_at":"2022-08-27T01:40:53.540Z","dependency_job_id":null,"html_url":"https://github.com/claudyus/LXC-Web-Panel","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/claudyus%2FLXC-Web-Panel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/claudyus%2FLXC-Web-Panel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/claudyus%2FLXC-Web-Panel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/claudyus%2FLXC-Web-Panel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/claudyus","download_url":"https://codeload.github.com/claudyus/LXC-Web-Panel/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230400616,"owners_count":18219831,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["interface","lxc","python"],"created_at":"2024-11-13T08:51:47.161Z","updated_at":"2024-12-19T08:08:35.068Z","avatar_url":"https://github.com/claudyus.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"LXC-Web-Panel\n=============\n\n.. image:: https://travis-ci.org/claudyus/LXC-Web-Panel.svg?branch=master\n    :target: https://travis-ci.org/claudyus/LXC-Web-Panel\n\nThis is a fork of the original LXC-Web-Panel from https://github.com/lxc-webpanel/LXC-Web-Panel with a lot of improvements and bug fixes for LXC 1.0+.\n\nThis version of lwp features backup capability, RestAPI interface, LDAP support, and other necessary fixes to work with the latest lxc version. This project is also available as debian package for easy installation.\n\nIf you use this fork please ensure to use at least lxc 1.0.4. The code was tested on Ubuntu 12.04 and 14.04.\n\nOn ubuntu 12.04 you should install:\n\n  - LXC from this ppa: https://launchpad.net/~ubuntu-lxc/+archive/daily\n  - python-flask from ppa: https://launchpad.net/~chris-lea/+archive/python-flask\n\nInstallation on deb based system\n------------------------------------\n\nThe latest debian packages are released using packagecloud.io service since version 0.9, please update your repo config.\nThe install script can be found at https://packagecloud.io/claudyus/LXC-Web-Panel/install\n\nInstallation of the package can be done typing::\n\n  sudo apt-get install lwp\n\nVersion released before 0.9 can be downloaded at http://claudyus.github.io/LXC-Web-Panel/download.html\n\n\nInstallation on rpm system or from source code\n----------------------------------------------\n\nIf you want to run lwp from source code or in a rpm based system like Fedora you can follow the steps below.\n\nOn a fedora system you should install these deps.\n\n::\n\n  sudo yum update\n  sudo yum install lxc lxc-devel lxc-libs lxc-extra lxc-templates python-pam python-flask fabric pytz npm\n\nNow you should download the source code and inside the source code directory run these steps below\n\n::\n\n  fab build_assets         # build assets using python-fabric\n  ./setup.py develop       # install python package\n  mkdir -p /etc/lwp        # create config/var dirs and popolate it\n  mkdir -p /var/lwp\n  cp lwp.example.conf /etc/lwp/lwp.conf\n  cp lwp.db /var/lwp/lwp.db\n  service firewalld stop   # for fedora\n  service lxc start        # if service lxc exists\n  ./bin/lwp --debug        # run lwp wth debug support\n\n\nConfiguration\n-------------\n\n1. Copy /etc/lwp/lwp.example.conf to /etc/lwp/lwp.conf\n2. edit it\n3. start lwp service as root ``service lwp start``\n\nYour lwp panel is now at http://localhost:5000/ and default username and password are admin/admin.\n\nSSL configuration\n^^^^^^^^^^^^^^^^^\n\nSSL direct support was dropped after v0.6 release.\n\nYou can configure nginx as reverse proxy if you want to use SSL encryption, see `bug #34 \u003chttps://github.com/claudyus/LXC-Web-Panel/issues/34\u003e`_ for info.\n\n\nAuthentication methods\n^^^^^^^^^^^^^^^^^^^^^^\n\nDefault authentication is against the internal sqlite database, but it's possible to configure alternative backends.\n\nLDAP\n++++\n\nTo enable ldap auth you should set ``auth`` type to ``ldap`` inside your config file then configure all options inside ldap section.\nSee lwp.example.conf for references.\n\nPyhton LDAP need to be installed::\n\n  apt-get install python-ldap\n\nhtpasswd\n++++++++\n\nTo enable authentication against htpasswd file you should set ``auth`` type to ``htpasswd`` and ``file`` variable in ``htpasswd`` section to point to the htpasswd file.\n\nThis backend use the crypt function, here an example where ``-d`` force the use of crypt encryption when generating the htpasswd file::\n\n  htpasswd -d -b -c /etc/lwp/httpasswd admin admin\n\nPAM\n+++\n\nTo enable authentication against PAM you should set ``auth`` type to ``pam`` and ``service`` variable in ``pam`` section.\nPython PAM module needs to be installed::\n\n  apt-get install python-pam\n\nor\n\n::\n\n  pip install pam\n\nor\n\n::\n\n  yum install python-pam\n\nWith default ``login`` service all valid linux users can login to lwp.\nMany more options are available via PAM Configuration, see PAM docs.\n\nHTTP\n+++++\n\nThis 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.\n\nCustom autenticators\n++++++++++++++++++++\n\nIf you want to use different type of authentication, create appropriate file in ``authenticators/`` directory with specific structure (example can be viewed in ``stub`` authenticator)\n\nFile-bucket configuration\n^^^^^^^^^^^^^^^^^^^^^^^^^\n\nTo enable `file bucket \u003chttp://claudyus.github.io/file-bucket/\u003e`_ integration for the backup routine you shoul set to ``true`` the ``buckets`` key inside the global section of configuation file.\nThan add a section ``buckets`` like this::\n\n [global]\n .\n .\n buckets = True\n\n [buckets]\n buckets_host = remote_lan_ip\n buckets_port = 1234\n\n\nDevelopers/Debug\n----------------\n\nAfter a fresh git clone you should download the bower component and setup the package for development purpose.\n\n::\n\n fab build_assets\n sudo ./setup.py develop\n cp lwp.example.conf lwp.conf\n\nNow you can run lwp locally using ``sudo ./bin/lwp --debug``\n\nDebug is just one of the available options to profile lwp you can use ``--profiling`` options, those options can also be\nused against the global installation using: ``sudo lwp --debug``\n\nAnyway ensure to stop the lwp service if any: ``sudo service lwp stop``\n\nTo run test locally unsure that mock-lxc scripts are in PATH (``export PATH=`pwd`/tests/mock-lxc:$PATH``) than run ``fab dev_test``\n\nTo build a local debian package run ``fab debian``\n\nLICENSE\n-------\nThis work is released under MIT License, see LICENSE file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclaudyus%2Flxc-web-panel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fclaudyus%2Flxc-web-panel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclaudyus%2Flxc-web-panel/lists"}