podterminal/README.md

26 lines
1.0 KiB
Markdown
Raw Normal View History

2024-01-28 11:31:57 +01:00
# Podterminal
This project is a small go reverse proxy that spins up a container for each session, allowing multiple simultaneous
Users to use Webtop in their own, separate session. A good illustration is this:
![Webtop Inception](doc/podterminal_inception.png)
## Building
To build the project, you can just use "make"
2024-01-29 15:55:15 +01:00
On Debian 12, you will need the following dependencies:
2024-02-03 11:11:10 +01:00
```sh
2024-01-29 15:55:15 +01:00
apt install -y git wget podman make gcc libgpgme-dev build-essential pkgconf pkgconf-bin libdevmapper-dev libbtrfs-dev
```
2024-02-01 17:32:46 +01:00
## Installing
Executing `make install` will install and start podterminal as a systemd service, including an example config file.
2024-02-03 11:11:10 +01:00
## Usage
There is some basic Documentation in the config file to explain the usage of the keys. For more in-depth explanations
feel free to contact me, and I will add it to the documentation
## Known Bugs
- Images need to be pulled first as root
- Not compatible with default KASM Docker images (needs http WSS access)
- reloading browser on startup might be necessary, especially if the target image is slow to start