https://github.com/scality/zenko-ui
Zenko UI
https://github.com/scality/zenko-ui
artesca zenko
Last synced: 5 months ago
JSON representation
Zenko UI
- Host: GitHub
- URL: https://github.com/scality/zenko-ui
- Owner: scality
- Created: 2020-02-13T17:11:16.000Z (over 6 years ago)
- Default Branch: development/2.2
- Last Pushed: 2025-04-10T13:25:22.000Z (about 1 year ago)
- Last Synced: 2025-04-10T14:48:49.920Z (about 1 year ago)
- Topics: artesca, zenko
- Language: TypeScript
- Homepage:
- Size: 17 MB
- Stars: 11
- Watchers: 41
- Forks: 3
- Open Issues: 52
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# Zenko UI
[](https://codecov.io/gh/scality/zenko-ui)
Zenko UI is our portal to manage offline Zenko instances.
It provides a user interface for:
- Monitoring the health of the processes
- Managing storage accounts and users
- Browsing in buckets
- Managing workflows (replication, transition, expiration)
- Adding data access
- Adding storage locations
- Monitoring S3 data accesses
## How to start
### Connect to Scality VPN
The Zenko deployment runs on a VPN-accessible scality.cloud instance.
### Add entries to your local /etc/hosts file
```
NODE_IP="put-the-node-ip"
echo "$NODE_IP keycloak.zenko.local iam.zenko.local sts.zenko.local management.zenko.local s3.zenko.local" >>/etc/hosts
```
### Start Zenko UI locally
```
npm install
npm run start:dev
```
Zenko UI now uses the metalk8s common navbar:
```
git clone https://github.com/scality/metalk8s
cd metalk8s/shell-ui
docker build -t shell-ui .
docker run -d -p 8082:80 shell-ui
```
### Access UI
```
http://127.0.0.1:8383
```
must be redirected to the Keycloak login page:
```
Username or email: bartsimpson
Password: 123
```
*Note*: Keycloak uses cookies to manage user sessions. A SameSite cookie
prevents cookies from being sent in cross-site requests, to defend against
CSRF attacks. To make the local UI work, request it using a matched domain
(e.g., *.zenko.local).
## Test
```bash
npm run test
```
## Authentication
[documentation](documentation/AUTHENTICATION.md)
## Release
[documentation](documentation/RELEASE.md)