{"id":19378823,"url":"https://github.com/linbit/linstor-gui","last_synced_at":"2025-04-23T19:32:32.976Z","repository":{"id":256733568,"uuid":"856221348","full_name":"LINBIT/linstor-gui","owner":"LINBIT","description":"HTML5 GUI frontend for LINSTOR","archived":false,"fork":false,"pushed_at":"2025-04-18T09:19:02.000Z","size":4149,"stargazers_count":27,"open_issues_count":4,"forks_count":10,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-04-18T22:47:14.434Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LINBIT.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-09-12T07:47:01.000Z","updated_at":"2025-04-18T09:19:05.000Z","dependencies_parsed_at":"2024-11-04T08:17:56.307Z","dependency_job_id":"849d72fe-7d50-4df3-907b-2c330b6b5ce9","html_url":"https://github.com/LINBIT/linstor-gui","commit_stats":null,"previous_names":["linbit/linstor-gui"],"tags_count":53,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LINBIT%2Flinstor-gui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LINBIT%2Flinstor-gui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LINBIT%2Flinstor-gui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LINBIT%2Flinstor-gui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LINBIT","download_url":"https://codeload.github.com/LINBIT/linstor-gui/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250499922,"owners_count":21440715,"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":[],"created_at":"2024-11-10T09:07:30.043Z","updated_at":"2025-04-23T19:32:32.970Z","avatar_url":"https://github.com/LINBIT.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# LINSTOR GUI\n\n[![Open Source](https://img.shields.io/badge/Open-Source-brightgreen)](https://opensource.org/) [![GPLv3 License](https://img.shields.io/badge/License-GPL%20v3-brightgreen.svg)](https://opensource.org/licenses/) [![Active](http://img.shields.io/badge/Status-Active-green.svg)](https://linbit.com/linstor) [![GitHub Release](https://img.shields.io/github/release/linbit/linstor-gui.svg?style=flat)](https://github.com/LINBIT/linstor-gui) [![GitHub Commit](https://img.shields.io/github/commit-activity/y/linbit/linstor-gui)](https://github.com/LINBIT/linstor-gui) [![Support](https://img.shields.io/badge/-Enterprise%20Support-f78f22)](https://www.linbit.com/support/) [![Community Forum](https://img.shields.io/badge/-Community%20Forum-1d2a3a)](https://forums.linbit.com/c/linstor/6)\n\nA web-based graphical user interface for LINBIT SDS (LINSTOR\u0026reg;, DRBD\u0026reg;, and related software).\n\n## Description\n\n`linstor-gui` is a web-based graphical user interface (GUI) for LINBIT SDS.\nIt provides a user-friendly way to create, manage, and monitor LINSTOR storage objects, such as storage pools, resource groups, resources, volumes, and snapshots.\n`linstor-gui` communicates with the LINSTOR API to perform various operations, such as creating and deleting storage pools.\nThe GUI also provides a dashboard that displays information about the LINSTOR cluster, such as the status of nodes and volumes.\n\n## Getting Started\n\n### Installation on a LINSTOR controller node\n\nThis package does not have a standalone server; it requires the LINSTOR environment and serves files through the LINSTOR server. It should be installed on the machine running the LINSTOR controller. After installation, it can be accessed via a URL like `http://192.168.123.105:3370/ui/#!/`, replacing `192.168.123.105` with the IP address of your LINSTOR controller. Please choose your own Linux distribution, for Ubuntu and Debian:\n\n```\nsudo add-apt-repository ppa:linbit/linbit-drbd9-stack\nsudo apt install linstor-gui\n```\n\n### Running in a Docker container\n\n```\ndocker build -t linstor-gui .\n\ndocker run \\\n  -p 8000:8000 \\\n  -e LB_LINSTOR_API_HOST=http://192.168.123.105:3370 \\\n  -e LB_GATEWAY_API_HOST=http://192.168.123.105:8080 \\\n  linstor-gui\n\n```\n\nLB_LINSTOR_API_HOST is required, LB_GATEWAY_API_HOST is optional, default is `http://localhost:8080`.\n\n### Running development mode on local machine(for developers)\n\n- `npm install`\n- Create a `.env` file in the root directory with the following variables:\n\n```\n# The hostname or IP address running the `linstor-gui` (optional)\nVITE_HOST=127.0.0.1\n# The port of the `linstor-gui` (optional)\nVITE_PORT=8080\n# The version of the `linstor-gui` (optional)\nVITE_VERSION=DEV\n# The host of the LINSTOR API\nVITE_LINSTOR_API_HOST=http://192.168.123.214:3370\n# The host of the LINSTOR GATEWAY API (optional)\nVITE_GATEWAY_API_HOST=http://192.168.123.214:8080\n# The host of the LINBIT VSAN API (optional)\nVITE_VSAN_API_HOST=https://192.168.123.214\n```\n\n- `npm run start:dev`,\n- Open your browser and navigate to `http://localhost:8080`\n\n## Help\n\nTo report a problem with this software or to make a feature request, open an issue within this project.\nFor help developing or contributing to this software, contact the author.\nFor support using the software, you can seek help within the [LINBIT Community Forums](https://forums.linbit.com/).\nOr as a LINBIT support customer, you can open a support ticket from your LINBIT customer account.\n\n## Authors\n\n- [Liang Li](mailto:liang.li@linbit.com)\n\n## Contributions\n\nContributions are welcome! Either raise and Github issue if you find a bug or create a pull request if you have a fix or new feature.\n\n## License\n\nThis project is licensed under the GPL-3.0 License - see the COPYING file for details\n\n## Acknowledgments\n\nLINSTOR GUI is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 3 of the License. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinbit%2Flinstor-gui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flinbit%2Flinstor-gui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinbit%2Flinstor-gui/lists"}