Skip to content
Back to search

teleskopio

teleskopio is a lightweight kubernetes web client

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/teleskopio--teleskopio/badge.svg)](/listings/teleskopio--teleskopio)

HTML

<a href="/listings/teleskopio--teleskopio"><img src="/api/listings/teleskopio--teleskopio/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Linux

Download [release](https://github.com/teleskopio/teleskopio/releases).

MacOS

Use brew (ARM and Intel):

1. `brew tap teleskopio/homebrew-teleskopio` 1. `brew install --cask teleskopio`

Docker

1. Pull docker image from [Packages](https://github.com/teleskopio/teleskopio/pkgs/container/teleskopio)

docker pull ghcr.io/teleskopio/teleskopio:latest

2. Generate config

docker run -it --rm ghcr.io/teleskopio/teleskopio:latest config > config.yaml

3. Edit config, generate user passwords, add kube configs

$ htpasswd -nbB admin MySecret123 # apache2-utils
> admin:$2y$05$U7puDu7wKOMP6i4eI1nO4ux909bH8FuPadEQq2oxx7SRXrBh3xJIG
vim config.yaml # edit confAig and add admin user
# add kubeconfig content to kube.configs
# check example in config.yaml

4. Run

Run with `--network=host` if you're using kind cluster

docker run -it --rm --network=host -p 3080:3080 \
  -v $(pwd)/config.yaml:/usr/bin/config.yaml ghcr.io/teleskopio/teleskopio:latest \
  --config=/usr/bin/config.yaml

Or run with docker network

docker run -it --rm -p 3080:3080 \
  -v $(pwd)/config.yaml:/usr/bin/config.yaml ghcr.io/teleskopio/teleskopio:latest \
  --config=/usr/bin/config.yaml
5:47AM INF set loglevel level=DEBUG
5:47AM INF version version=""
5:47AM INF initialize web server addr=:3080
...

Helm

Right now only building `helm` package from sources install option available.

[Clone repository](https://github.com/teleskopio/teleskopio). Run `make build-helm-chart` (`helm` binary in `PATH` is required.)

Check out `helm` chart [`values.yaml`](https://github.com/teleskopio/teleskopio/blob/master/deploy/teleskopio/values.yaml).

By default `RBAC's` for `teleskopio` give access to **all cluster and to any kind of operation**.

$ git clone git@github.com:teleskopio/teleskopio.git
$ cd teleskopio
$ make build-helm-char
helm package ./deploy/teleskopio
Successfully packaged chart and saved it to: /home/dev/teleskopio/teleskopio-0.1.4.tgz
# Add you own config.yaml
$ cat config.yaml
service:
  type: ClusterIP
  port: 3090

config:
  name: config
  content:
    log_color: false
    log_json: true
    log_level: INFO
    server_http: ":3090"
    jwt_key: "b2436e01424c714e4583f2f2851a0e1304440157" # openssl rand -hex 20
    auth_disabled: false
    users:
      - username: admin
        password: "$2y$05$PgEhSAwkE0RlbYiJqSxF/e529Xu5HGey.cEY/qqoksLlFckk3kaiW" # htpasswd -nbB admin MySecret123
        role: "admin"
      - username: user
        password: "$2y$05$PgEhSAwkE0RlbYiJqSxF/e529Xu5HGey.cEY/qqoksLlFckk3kaiW"
        role: "viewer"
    kube:
      configs:
# Install local helm chart with own values.yaml
$ helm install teleskopio ./teleskopio-0.1.4.tgz -f values.yaml
NAME: teleskopio
LAST DEPLOYED: Sun Feb  1 15:39:52 2026
NAMESPACE: default
STATUS: deployed
REVISION: 1
DESCRIPTION: Install complete
NOTES:
1. Get the application URL by running these commands:
  export POD_NAME=$(kubectl get pods --namespace default -l "app.kubernetes.io/name=teleskopio,app.kubernetes.io/instance=teleskopio" -o jsonpath="{.items[0].metadata.name}")
  export CONTAINER_PORT=$(kubectl get pod --namespace default $POD_NAME -o jsonpath="{.spec.containers[0].ports[0].containerPort}")
  echo "Visit http://127.0.0.1:8080 to use your application"
  kubectl --namespace default port-forward $POD_NAME 8080:$CONTAINER_PORT

# Follow NOTES instruction and use port-forward
$ kubectl --namespace default port-forward $POD_NAME 8080:$CONTAINER_PORT
Forwarding from 127.0.0.1:8080 -> 3090
Forwarding from [::1]:8080 -> 3090

Open [http://127.0.0.1:8080](http://127.0.0.1:8080).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 159 lines · 1 finding marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p>
  2. <div align="center">
  3. <a href="https://teleskopio.github.io">
  4. <img src="assets/icon.png" alt="teleskopio lightweight kubernetes web client" width="120" height="120" />
  5. </a>
  6. </div>
  7. <div align="center">
  8. <p><a href="https://teleskopio.github.io">teleskopio</a> lightweight kubernetes web client.</p>
  9. </div>
  10. </p>
  11. <div aligh="center">
  12. <img src="assets/preview-light.png" alt="teleskopio lightweight kubernetes web client" width="100%" />
  13. <img src="assets/preview-dark.png" alt="teleskopio lightweight kubernetes web client" width="100%" />
  14. </div>
  15. ## Features
  16. - Multiple config support – respect `$KUBECONFIG` variable and checks the `config.yaml` file.
  17. - Simple `JWT` token authorization, admin and viewer role - Full access (admin) or Read Only access (viewer) to cluster.
  18. - [Resource editor/creator](https://teleskopio.github.io/howtos/teleskopio-with-kind/#deploy-a-pod-2) - integrated [Monaco Editor](https://microsoft.github.io/monaco-editor/) with syntax highlighting.
  19. - Live updates - real-time resource changes with `Kubernetes` watchers.
  20. - `Pod` logs and `Event`'s - inspect logs and event history directly in the UI, owner links, share link to resource.
  21. - [Light and dark themes](https://teleskopio.github.io/howtos/teleskopio-with-kind/#theme-and-font-2) and fonts.
  22. - [Scale resources](https://teleskopio.github.io/howtos/teleskopio-with-kind/#scale-resources-2) `Deployments`, `ReplicaSets`
  23. - Shortcuts to filter `CTRL + F` any resource, jump to section `CTRL + J` any menu.
  24. - [Objects multi-select operations](https://teleskopio.github.io/howtos/teleskopio-with-kind/#multiselect-2) (delete, drain, cordon, e.t.c.)
  25. - [`go-client`](https://github.com/kubernetes/client-go) - based native implementation that interacts directly with the Kubernetes API server, no pulling, only websocket events.
  26. - Kubernetes [resource schemas](https://github.com/yannh/kubernetes-json-schema?tab=readme-ov-file#kubernetes-json-schemas) per API version.
  27. - [Helm integration](https://teleskopio.github.io/howtos/teleskopio-helm-integration).
  28. - Zero dependencies, no need to install `kubectl`, `helm` on the host.
  29. - Air-gapped environments ready. No external requests.
  30. - Built-in [MCP server](https://teleskopio.github.io/howtos/mcp-server)
  31. ## Install
  32. #### Linux
  33. Download [release](https://github.com/teleskopio/teleskopio/releases).
  34. #### MacOS
  35. Use brew (ARM and Intel):
  36. 1. `brew tap teleskopio/homebrew-teleskopio`
  37. 1. `brew install --cask teleskopio`
  38. #### Docker
  39. 1. Pull docker image from [Packages](https://github.com/teleskopio/teleskopio/pkgs/container/teleskopio)
  40. ```sh
  41. docker pull ghcr.io/teleskopio/teleskopio:latest
  42. ```
  43. 2. Generate config
  44. ```sh
  45. docker run -it --rm ghcr.io/teleskopio/teleskopio:latest config > config.yaml
  46. ```
  47. 3. Edit config, generate user passwords, add kube configs
  48. ```sh
  49. $ htpasswd -nbB admin MySecret123 # apache2-utils
  50. > admin:$2y$05$U7puDu7wKOMP6i4eI1nO4ux909bH8FuPadEQq2oxx7SRXrBh3xJIG
    • Dismissed after review: Contains a long base64-looking blob — not necessarily malicious, but worth inspecting what it decodes to
    • Line 66 on GitHub
  51. vim config.yaml # edit confAig and add admin user
  52. # add kubeconfig content to kube.configs
  53. # check example in config.yaml
  54. ```
  55. 4. Run
  56. Run with `--network=host` if you're using kind cluster
  57. ```bash
  58. docker run -it --rm --network=host -p 3080:3080 \
  59. -v $(pwd)/config.yaml:/usr/bin/config.yaml ghcr.io/teleskopio/teleskopio:latest \
  60. --config=/usr/bin/config.yaml
  61. ```
  62. Or run with docker network
  63. ```bash
  64. docker run -it --rm -p 3080:3080 \
  65. -v $(pwd)/config.yaml:/usr/bin/config.yaml ghcr.io/teleskopio/teleskopio:latest \
  66. --config=/usr/bin/config.yaml
  67. 5:47AM INF set loglevel level=DEBUG
  68. 5:47AM INF version version=""
  69. 5:47AM INF initialize web server addr=:3080
  70. ...
  71. ```
  72. #### Helm
  73. Right now only building `helm` package from sources install option available.
  74. [Clone repository](https://github.com/teleskopio/teleskopio). Run `make build-helm-chart` (`helm` binary in `PATH` is required.)
  75. Check out `helm` chart [`values.yaml`](https://github.com/teleskopio/teleskopio/blob/master/deploy/teleskopio/values.yaml).
  76. By default `RBAC's` for `teleskopio` give access to **all cluster and to any kind of operation**.
  77. ```bash
  78. $ git clone git@github.com:teleskopio/teleskopio.git
  79. $ cd teleskopio
  80. $ make build-helm-char
  81. helm package ./deploy/teleskopio
  82. Successfully packaged chart and saved it to: /home/dev/teleskopio/teleskopio-0.1.4.tgz
  83. # Add you own config.yaml
  84. $ cat config.yaml
  85. service:
  86. type: ClusterIP
  87. port: 3090
  88. config:
  89. name: config
  90. content:
  91. log_color: false
  92. log_json: true
  93. log_level: INFO
  94. server_http: ":3090"
  95. jwt_key: "b2436e01424c714e4583f2f2851a0e1304440157" # openssl rand -hex 20
  96. auth_disabled: false
  97. users:
  98. - username: admin
  99. password: "$2y$05$PgEhSAwkE0RlbYiJqSxF/e529Xu5HGey.cEY/qqoksLlFckk3kaiW" # htpasswd -nbB admin MySecret123
  100. role: "admin"
  101. - username: user
  102. password: "$2y$05$PgEhSAwkE0RlbYiJqSxF/e529Xu5HGey.cEY/qqoksLlFckk3kaiW"
  103. role: "viewer"
  104. kube:
  105. configs:
  106. # Install local helm chart with own values.yaml
  107. $ helm install teleskopio ./teleskopio-0.1.4.tgz -f values.yaml
  108. NAME: teleskopio
  109. LAST DEPLOYED: Sun Feb 1 15:39:52 2026
  110. NAMESPACE: default
  111. STATUS: deployed
  112. REVISION: 1
  113. DESCRIPTION: Install complete
  114. NOTES:
  115. 1. Get the application URL by running these commands:
  116. export POD_NAME=$(kubectl get pods --namespace default -l "app.kubernetes.io/name=teleskopio,app.kubernetes.io/instance=teleskopio" -o jsonpath="{.items[0].metadata.name}")
  117. export CONTAINER_PORT=$(kubectl get pod --namespace default $POD_NAME -o jsonpath="{.spec.containers[0].ports[0].containerPort}")
  118. echo "Visit http://127.0.0.1:8080 to use your application"
  119. kubectl --namespace default port-forward $POD_NAME 8080:$CONTAINER_PORT
  120. # Follow NOTES instruction and use port-forward
  121. $ kubectl --namespace default port-forward $POD_NAME 8080:$CONTAINER_PORT
  122. Forwarding from 127.0.0.1:8080 -> 3090
  123. Forwarding from [::1]:8080 -> 3090
  124. ```
  125. Open [http://127.0.0.1:8080](http://127.0.0.1:8080).
  126. ## Configuration
  127. [config.example](pkg/config/config.TEMPLATE.yaml)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.