Add arch-linuxserver DevContainer template

Added new DevContainer template for GUI application development with
web-based desktop access using LinuxServer.io images

Provides web-accessible desktop environments (KDE, XFCE, i3, MATE,
KasmVNC) for remote GUI development workflows and cross-platform
compatibility

Task: [15](#15)

Author: zyrakq

.github/workflows/README.md

@@ -31,6 +31,7 @@ act workflow_dispatch -W .github/workflows/test-local.yaml
 
 # Test specific template
 act workflow_dispatch -W .github/workflows/test-local.yaml --input template=arch-base
+act workflow_dispatch -W .github/workflows/test-local.yaml --input template=arch-linuxserver
 ```
 
 ## 🔧 Adding New Templates

.github/workflows/test-local.yaml

@@ -28,8 +28,9 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        templates: 
+        templates:
           - arch-base
+          - arch-linuxserver
     steps:
       - name: Checkout repository
         uses: actions/checkout@v3

.github/workflows/test-pr.yaml

@@ -14,6 +14,7 @@ jobs:
         with:
           filters: |
             arch-base: ./**/arch-base/**
+            arch-linuxserver: ./**/arch-linuxserver/**
 
   test:
     needs: [detect-changes]

README.md

@@ -7,7 +7,7 @@ A collection of templates for VS Code Dev Containers, designed for quick develop
 1. 📂 Open VS Code in your project folder
 2. ⌨️ Press `Ctrl+Shift+P` and select "Dev Containers: Add Dev Container Configuration Files..."
 3. 📋 Choose "Show All Definitions..."
-4. 🔍 In the search field, enter: `ghcr.io/zyrakq/arch-devcontainer-templates/arch-base`
+4. 🔍 In the search field, enter: `ghcr.io/zyrakq/arch-devcontainer-templates/arch-base` or `ghcr.io/zyrakq/arch-devcontainer-templates/arch-linuxserver`
 5. ✅ Select the desired template from the list
 
 ## 📦 Available Templates
@@ -19,6 +19,14 @@ Base template based on Arch Linux with:
 - 💾 Separate volumes for home directory and workspace
 - 🔒 Custom network isolation
 
+### 🖥️ arch-linuxserver
+Desktop template based on LinuxServer.io images with:
+- 🌐 Web-based GUI access via browser (port 3000)
+- 🖥️ 5 desktop environments: KDE, i3, MATE, XFCE, or terminal-only (kasmvnc)
+- 🐧 Arch Linux base with LinuxServer.io optimizations
+- 👤 User `abc` with HOME at `/config`
+- 🔧 PUID/PGID support for proper file permissions
+
 ## ⚡ Available Features
 
 | Feature | Repository |
@@ -40,7 +48,15 @@ Base template based on Arch Linux with:
 ## ⚙️ Template Parameters
 
 When using the template, you'll be prompted to specify:
+
+### arch-base
+- 📝 **Project Name**: Project name (used for container and network names)
+
+### arch-linuxserver
+- 🎨 **Desktop Environment**: Choose from kasmvnc, kde, i3, mate, or xfce
 - 📝 **Project Name**: Project name (used for container and network names)
+- 🏷️ **Title**: Title displayed in the web interface
+- 🕐 **Timezone**: Timezone for the container (e.g., Europe/London, America/New_York)
 
 ## 📁 Template Structure
 

TESTING.md

@@ -37,14 +37,18 @@ act workflow_dispatch -W .github/workflows/test-local.yaml
 ### 🎯 Testing specific template
 ```bash
 # Test specific template
-act workflow_dispatch -W .github/workflows/test-local.yaml --input template=arch-base
+act workflow_dispatch -W .github/workflows/test-local.yaml --input template=arch-linuxserver
 ```
 
 ### 🛠️ Manual testing
 ```bash
-# Direct smoke-test execution for specific template
+# Direct smoke-test execution for arch-base
 ./.github/actions/smoke-test/build.sh arch-base
 ./.github/actions/smoke-test/test.sh arch-base
+
+# Direct smoke-test execution for arch-linuxserver
+./.github/actions/smoke-test/build.sh arch-linuxserver
+./.github/actions/smoke-test/test.sh arch-linuxserver
 ```
 ## 📋 Workflow Types
 
@@ -61,6 +65,7 @@ act workflow_dispatch -W .github/workflows/test-local.yaml --input template=arch
 - **Commands:**
   - All: `act workflow_dispatch -W .github/workflows/test-local.yaml`
   - Single: `act workflow_dispatch -W .github/workflows/test-local.yaml --input template=arch-base`
+  - LinuxServer: `act workflow_dispatch -W .github/workflows/test-local.yaml --input template=arch-linuxserver`
 
 ## �️ Testing structure
 
@@ -81,6 +86,14 @@ The `test/arch-base/test.sh` file contains detailed tests:
 - 📁 File system verification
 - 🔧 Environment variables testing
 
+The `test/arch-linuxserver/test.sh` file contains LinuxServer-specific tests:
+- 🖥️ Desktop environment verification
+- 🌐 Web interface accessibility (port 3000)
+- 👤 LinuxServer user configuration (`abc` user)
+- 🔧 PUID/PGID environment variables
+- 📁 Volume mount verification (`/config`, `/workspace`)
+- 🎨 Desktop environment specific checks
+
 ## 🔧 Troubleshooting
 
 ### 🐳 Docker issues

src/arch-base/NOTES.md

@@ -167,7 +167,10 @@ sudo pacman-key --refresh-keys
 - 📚 **Documentation**: [GitHub Repository](https://github.com/zyrakq/devcontainer-templates)
 - 🐛 **Issues**: Report issues via GitHub Issues
 - 📖 **Arch Wiki**: [Arch Linux Wiki](https://wiki.archlinux.org/)
-- 🐳 **Dev Containers**: [Official Documentation](https://containers.dev/)
+- 🔗 **Related Templates**:
+  - **[Arch Linux Base](../arch-base/NOTES.md)** - Minimalist Arch Linux environment without desktop (current)
+  - **[Arch Linux Desktop](../arch-linuxserver/NOTES.md)** - Full desktop environment with web access
+- � **Dev Containers**: [Official Documentation](https://containers.dev/)
 - 🔗 **Related Projects**:
   - [bartventer/devcontainer-images](https://github.com/bartventer/devcontainer-images/) - Comprehensive collection of Dev Container images and features
   - [bartventer/arch-devcontainer-features](https://github.com/bartventer/arch-devcontainer-features/) - DevContainer features for Arch Linux by bartventer

src/arch-linuxserver/.devcontainer/Dockerfile

@@ -0,0 +1,19 @@
+ARG BASE_IMAGE="lscr.io/linuxserver/webtop:arch-kde"
+
+FROM ${BASE_IMAGE}
+
+LABEL org.opencontainers.image.title="Arch Linux Desktop (LinuxServer)"
+LABEL org.opencontainers.image.source="https://github.com/zyrakq/arch-devcontainer-templates"
+LABEL org.opencontainers.image.description="Arch Linux with desktop environment using LinuxServer.io images"
+LABEL org.opencontainers.image.licenses="MIT"
+LABEL org.opencontainers.image.authors="Zyrakq <serg.shehov@tutanota.com>"
+
+# Adjust directory permissions
+RUN chmod 555 /srv/ftp && \
+    chmod 755 /usr/share/polkit-1/rules.d/
+
+# Initialize pacman keyring and upgrade system
+RUN pacman-key --init && \
+    pacman-key --populate archlinux && \
+    pacman -Sy --needed --noconfirm --disable-download-timeout archlinux-keyring && \
+    pacman -Su --noconfirm --disable-download-timeout

src/arch-linuxserver/.devcontainer/devcontainer.json

@@ -0,0 +1,50 @@
+{
+    "name": "${templateOption:projectName} Desktop (LinuxServer)",
+    "build": {
+        "dockerfile": "Dockerfile",
+        "context": ".",
+        "args": {
+            "BASE_IMAGE": "${templateOption:baseImage}"
+        }
+    },
+    "workspaceFolder": "/workspace/${templateOption:projectName}",
+    "workspaceMount": "source=${templateOption:projectName}-workspace,target=/workspace/${templateOption:projectName},type=volume",
+    "mounts": [
+        "source=${templateOption:projectName}-home,target=/config,type=volume"
+    ],
+    "remoteUser": "abc",
+    "remoteEnv": {
+        "HOME": "/config"
+    },
+    "containerEnv": {
+        "PUID": "1000",
+        "PGID": "1000",
+        "TZ": "${templateOption:timezone}",
+        "TITLE": "${templateOption:title}"
+    },
+    "runArgs": [
+        "--name=${templateOption:projectName}-devcontainer",
+        "--hostname=${templateOption:projectName}",
+        "--network=${templateOption:projectName}-network",
+        "--shm-size=1gb"
+    ],
+    "features": {
+        "ghcr.io/bartventer/arch-devcontainer-features/common-utils:1": {
+            "username": "abc",
+            "additionalPackages": "base-devel",
+            "installZsh": true,
+            "installOhMyZsh": true,
+            "configureZshAsDefaultShell": true
+        }
+    },
+    "initializeCommand": "docker network create ${templateOption:projectName}-network 2>/dev/null || true",
+    "forwardPorts": [
+        3000
+    ],
+    "portsAttributes": {
+        "3000": {
+            "label": "Desktop Environment",
+            "onAutoForward": "openBrowser"
+        }
+    }
+}