uncookedconcept/tsh-in-docker repository overview

⁠Docker Client for Teleport's tsh CLI

⁠Run any tsh version anywhere, with kubectl and k9s included.

⁠ ⁠ ⁠

Run your Teleport⁠ tsh CLI inside a docker container, so you can use multiple tsh versions on the same machine. k9s and kubectl are included so you can interact with K8s cluster easily.

The image is based on Ubuntu 22.04.

⁠✨ Features

• Teleport Client (tsh): Access your Teleport clusters.
• kubectl: Interact with your Kubernetes clusters through the Teleport proxy.
• k9s: Browse your Kubernetes clusters with an enhanced terminal UI.
• Customizable: The version of each tool can be specified at build time.

⁠🚀 Getting Started

⁠Prerequisites

• Docker⁠ must be installed on your machine.

⁠Use the Pre-Built Image (Recommended)

The easiest way to get started is to pull the latest image from Docker Hub.

docker pull uncookedconcept/tsh-in-docker:latest

⁠Run a Container

To start an interactive shell within the environment, run the following command.

The -v volume mounts are essential to persist your tsh and kubectl configurations between sessions.

docker run --rm -it \
  -v ~/.tsh:/root/.tsh \
  -v ~/.kube:/root/.kube \
  uncookedconcept/tsh-in-docker:latest

⁠🔧 Customization (Local Build)

You can build the image locally to use specific versions of the included tools.

⁠1. Clone the Repository

git clone https://github.com/GestaltCaius/tsh-in-docker.git
cd tsh-in-docker

⁠2. Build the Image

You can override the default versions using --build-arg flags.

# Example: Build with a different version of tsh
docker build \
  --build-arg TELEPORT_VERSION=17.4.8 \
  -t tsh:17.4.8 .

⁠Available Build Arguments

⁠🤝 Contributing

Contributions are welcome! Please feel free to open an issue or submit a pull request.

⁠📜 License

This project is licensed under the AGPLv3 - see the LICENSE file for details.