WebUI Configuration

Customize how applications appear on the GoDoxy dashboard. Configure display names, icons, categories, and descriptions

Starting from v0.9, you can edit and hide/unhide apps directly from the WebUI by right-clicking.

WebUI edits override labels and route file settings.

Overview

The WebUI configuration determines how routes are displayed on the dashboard. You can configure these settings via Docker labels, route files, or directly in the WebUI.

Configuration Methods

Method	Description
Docker Labels	Configure per-container in `docker-compose.yml`
Route Files	Configure for non-Docker apps in `config/*.yml`
WebUI	Right-click menu for quick edits

Property Reference

Property	Description	Default	Values
`show`	Display on dashboard	`true`	boolean
`name`	Display name	Sanitized alias	string
`icon`	Dashboard icon	Auto-detected	icon reference
`url`	Override app URL	Dynamic	absolute URL
`category`	Dashboard category	Auto-detected	string
`description`	Short description	Empty	string

Icon Reference

Icons can be sourced from preset libraries or custom locations:

Source	Format	Example
Walkxcode presets	`@walkxcode/<filename>.png`	`@walkxcode/nginx.png`
Selfhst presets	`@selfhst/<filename>.svg`	`@selfhst/adguard-home.png`
Absolute URL	`https://...`	`https://example.com/icon.png`
Relative path	`/path/to/icon.png`	`/-/pwa-icons/logo-192.png`

Category Configuration

Categories are automatically detected from:

Container image names
Alias matches against selfh.st directory
GoDoxy's preset categories

Fallback categories:

Docker for Docker containers without matches
Others for unmatched routes

Examples

Docker Compose

services:
  gitlab:
    image: gitlab/gitlab-ce:latest
    container_name: gitlab
    restart: always
    labels:
      proxy.aliases: gitlab, gitlab-reg, gitlab-ssh
      # Main GitLab instance
      proxy.gitlab: |
        port: 80
        homepage:
          name: GitLab
          icon: "/-/pwa-icons/logo-192.png"
          description: GitLab CE instance
          category: dev
      # Registry (hidden from dashboard)
      proxy.gitlab-reg: |
        port: 5050
        homepage:
          show: false
      # SSH gateway (hidden from dashboard)
      proxy.gitlab-ssh: |
        port: "22223:22"
        homepage:
          show: false
    shm_size: 256m

Route File

# config/services.yml
adgh:
  host: 10.0.2.1
  homepage:
    name: AdGuard Home
    icon: "@selfhst/adguard-home.png"
    description: DNS filtering and ad blocking
    category: network

pihole:
  host: 10.0.2.2
  homepage:
    name: Pi-hole
    icon: "@selfhst/pihole.png"
    description: Network-wide ad blocking
    category: network

WebUI Interaction Guide

Editing Applications

Right-click on any application card
Select Edit App from the context menu
Modify display settings as needed
Changes apply immediately

Hiding Applications

Right-click on the application
Select Hide App
To unhide, right-click again and select Show App

Renaming Categories

Double-click the category header
Enter the new name
Press Enter to save

WebUI Configuration

On this page