Skip to content

Commit

Permalink
Fixes
Browse files Browse the repository at this point in the history
  • Loading branch information
crschnick committed Feb 15, 2025
1 parent e888212 commit 6227f05
Show file tree
Hide file tree
Showing 2 changed files with 10 additions and 87 deletions.
18 changes: 9 additions & 9 deletions Dockerfile
Original file line number Diff line number Diff line change
Expand Up @@ -43,14 +43,6 @@ RUN echo "**** install base packages ****" && \
/var/tmp/* \
/tmp/*

RUN echo "**** VsCode **** ($TARGETPLATFORM)" && \
if [ "$TARGETPLATFORM" = "linux/amd64" ]; then VSCODE_LINK="https://code.visualstudio.com/sha/download?build=stable&os=linux-deb-x64"; else VSCODE_LINK="https://code.visualstudio.com/sha/download?build=stable&os=linux-deb-arm64"; fi && \
wget -O vscode.deb "${VSCODE_LINK}" && \
DEBIAN_FRONTEND=noninteractive \
apt-get update && \
apt-get install --no-install-recommends -y "./vscode.deb" && \
rm "./vscode.deb"

# add local files
COPY /root /

Expand All @@ -63,7 +55,15 @@ RUN \
echo "**** add icon ****" && \
curl -L -o \
/kclient/public/icon.png \
https://rawcdn.githack.com/xpipe-io/xpipe/a097ae7a41131fa358b5343345557ad00a45c309/dist/logo/logo.png
https://rawcdn.githack.com/xpipe-io/xpipe/a097ae7a41131fa358b5343345557ad00a45c309/dist/logo/logo.png \

RUN echo "**** VsCode **** ($TARGETPLATFORM)" && \
if [ "$TARGETPLATFORM" = "linux/amd64" ]; then VSCODE_LINK="https://code.visualstudio.com/sha/download?build=stable&os=linux-deb-x64"; else VSCODE_LINK="https://code.visualstudio.com/sha/download?build=stable&os=linux-deb-arm64"; fi && \
wget -O vscode.deb "${VSCODE_LINK}" && \
DEBIAN_FRONTEND=noninteractive \
apt-get update && \
apt-get install --no-install-recommends -y "./vscode.deb" && \
rm "./vscode.deb"

RUN echo "**** install tool packages ****" && \
DEBIAN_FRONTEND=noninteractive \
Expand Down
79 changes: 1 addition & 78 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,81 +5,4 @@
XPipe Webtop is a web-based desktop environment that can be run in a container and accessed from a browser via KasmVNC.
The desktop environment comes with XPipe and various terminals and editors preinstalled and configured.

If you are using Kasm Workspaces, this image is also available in the [XPipe Kasm Registry](https://github.com/xpipe-io/kasm-registry).

## Application Setup

The Webtop can be accessed at:

* http://localhost:3000/
* https://localhost:3001/

## Authentication

Note that the authentication setup has to be done by you. By default, there is no authentication enabled and the webtop will be available to everyone.
So you have to be careful not to publicly expose it in that state.
As seen below, there are options to use basic HTTP authentication to restrict access.
However, this might also not be considered very secure, and it is recommended to use a proper separate authentication solution in front of the actual webtop environment.
Examples are Authelia, Authentik, KeyCloak, and others.

### Options in all KasmVNC based GUI containers

This container is based on [Docker Baseimage KasmVNC](https://github.com/linuxserver/docker-baseimage-kasmvnc) which means there are additional environment variables and run configurations to enable or disable specific functionality.

| Variable | Description |
| :----: | --- |
| CUSTOM_USER | HTTP Basic auth username, abc is default. |
| PASSWORD | HTTP Basic auth password, abc is default. If unset there will be no auth |
| SUBFOLDER | Subfolder for the application if running a subfolder reverse proxy, need both slashes IE `/subfolder/` |

## Usage

To help you get started creating a container from this image you can either use docker-compose or the docker cli.

The webtop image is available for both `linux/amd64` and `linux/arm64` platforms.

### docker-compose (recommended, [click here for more info](https://docs.linuxserver.io/general/docker-compose))

```yaml
---
services:
webtop:
image: ghcr.io/xpipe-io/xpipe-webtop:latest
container_name: xpipe-webtop
environment:
- SUBFOLDER=/ #optional
volumes:
- /path/to/data:/config
- /var/run/docker.sock:/var/run/docker.sock #optional
ports:
- 127.0.0.1:3000:3000
- 127.0.0.1:3001:3001
restart: unless-stopped
```
### docker cli ([click here for more info](https://docs.docker.com/engine/reference/commandline/cli/))
```bash
docker run -d \
--name=xpipe-webtop \
-e SUBFOLDER=/ `#optional` \
-p 127.0.0.1:3000:3000 \
-p 127.0.0.1:3001:3001 \
-v /path/to/data:/config \
-v /var/run/docker.sock:/var/run/docker.sock `#optional` \
--restart unless-stopped \
ghcr.io/xpipe-io/xpipe-webtop:latest
```

## Building locally

If you want to make local modifications to these images for development purposes or just to customize the logic:

```bash
git clone https://github.com/xpipe-io/xpipe-webtop.git
cd xpipe-webtop
docker build \
--no-cache \
--pull \
.
```
You can find the documentation at [https://docs.xpipe.io/guide/webtop](https://docs.xpipe.io/guide/webtop).

0 comments on commit 6227f05

Please sign in to comment.