Help Needed: Homepage Dashboard "Failed to construct 'URL'" Error

Hi everyone!

I'm encountering a persistent issue with my self-hosted Homepage dashboard (v1.1.1). Some tabs with bookmarks fail to load, showing the error:

TypeError: Failed to construct 'URL': Invalid URL

This happens on multiple tabs, including Accessibility_Resources and Shopping. I've tried troubleshooting by:

• Validating my YAML files (all are valid).
  
• Using lowercase tab names without special characters.
  
• Ensuring all URLs in bookmarks.yaml are absolute (http:// or https://).
  
• Clearing browser cache and testing in multiple browsers.
  

Despite these efforts, the issue persists. The error appears in the browser console as follows:

TypeError: Failed to construct 'URL': Invalid URL
    at F (index-3a04b80eb558747c.js:1:42899)
    at af (framework-bbeeca9707659ffa.js:1:65163)
    ...

I suspect the issue might be related to how Homepage processes bookmarks or tab names internally. Below are my full configuration files for reference (API keys and sensitive data redacted):

widgets.yaml

- search:
    provider: custom
    url: https://search.laniecarmelo.tech/search?q=%s
    target: _blank
    suggestionUrl: https://search.laniecarmelo.tech/autocompleter?q=%s
    showSearchSuggestions: true

- datetime:
    format:
        dateStyle: full
        timeStyle: long
        hour12: true

- openmeteo:
    label: Pipe Creek, TX
    latitude: 29.538
    longitude: -98.524
    units: imperial
    timezone: America/Chicago

docker.yaml

my-docker:
  socket: /var/run/docker.sock

bookmarks.yaml

---
- Accessibility_Resources:
    - WebAIM Accessibility Tools:
        abbr: WT
        href: https://webaim.org/resources/
        description: Tools and resources for web accessibility testing.
    - A11Y Project:
        abbr: AP
        href: https://www.a11yproject.com/
        description: Community-driven effort to make web accessibility easier.
    - W3C Web Accessibility Initiative:
        abbr: WA
        href: https://www.w3.org/WAI/
        description: Guidelines and resources for web accessibility.
    - WCAG Guidelines:
        abbr: WG
        href: https://www.w3.org/WAI/WCAG22/quickref/
        description: Quick reference for WCAG 2.1 guidelines.
    - Accessibility Resources:
        abbr: AR
        href: https://www.w3.org/WAI/resources/
        description: Comprehensive resources for web accessibility.
    - Accessibility Tools:
        abbr: AT
        href: https://www.w3.org/WAI/test-evaluate/
        description: Tools for testing and evaluating web accessibility.
    - Accessibility Tutorials:
        abbr: TU
        href: https://www.w3.org/WAI/tutorials/
        description: Tutorials on web accessibility best practices.
    - WebAlign:
        abbr: WL
        href: https://members.convergeaccessibility.com/member-log-in/
        description: Online tool for creating accessible web content.
    - Contrast Checker:
        abbr: CC
        href: https://webaim.org/resources/contrastchecker/
        description: Tool for checking color contrast ratios for accessibility.

- Automation:
    - Apprise Documentation:
        abbr: AD
        href: https://github.com/caronc/apprise/wiki/
        description: Notification management tool supporting multiple services.
    - Home Assistant Community:
        abbr: HC
        href: https://community.home-assistant.io/
        description: Forum for Home Assistant users to discuss automation setups.
    - Home Assistant Documentation:
        abbr: HD
        href: https://www.home-assistant.io/docs/
        description: Official documentation for Home Assistant.
    - Home Assistant Blog:
        abbr: HB
        href: https://www.home-assistant.io/blog/
        description: Updates and news about Home Assistant.

- Communication:
    - Shlink Documentation:
        abbr: SD
        href: https://shlink.io/documentation/
        description: Learn how to set up and manage Shlink.
    - Element:
        abbr: EL
        href: https://chat.tchncs.de/
        description: Secure messaging and collaboration platform.
    - Outlook:
        abbr: OL
        href: https://outlook.office365.com/
        description: Email and calendar service from Microsoft.
    - Google Messages:
        abbr: GM
        href: https://messages.google.com/
        description: SMS and MMS messaging service from Google.
    - Enafore:
        abbr: EN
        href: https://enafore.social/
        description: Alternative frontend for Mastodon, a decentralized social network.
    - Mastodon:
        abbr: MA
        href: https://allovertheplace.ca/
        description: Decentralized social network platform.
    - Discord:
        abbr: DC
        href: https://discord.com/
        description: Voice, video, and text chat platform for communities.

- Developer:
    - freeCodeCamp:
        abbr: FC
        href: https://www.freecodecamp.org/
        description: Learn to code with free tutorials and projects.
    - MDN Web Docs:
        abbr: MD
        href: https://developer.mozilla.org/
        description: Comprehensive web development documentation.
    - GitHub:
        abbr: GH
        href: https://github.com/
        description: Code hosting, collaboration, and version control.
    - Stack Overflow:
        abbr: SO
        href: https://stackoverflow.com/
        description: Community-driven Q&A for programmers.
    - GitLab:
        abbr: GL
        href: https://gitlab.com/
        description: Web-based DevOps lifecycle tool providing a Git repository manager.

- Information_Management:
    - AppleVis:
        abbr: AV
        href: https://www.applevis.com/
        description: Community for blind and low-vision users of Apple products.
    - BibleGateway:
        abbr: BG
        href: https://www.biblegateway.com/
        description: Search and read the Bible in multiple translations.
    - Bible Resources:
        abbr: BR
        href: https://biblehub.com/
        description: Online Bible study tools and comprehensive resources.
    - YouVersion:
        abbr: YV
        href: https://www.youversion.com/
        description: Bible app with various translations and reading plans.
    - Bible Study Fellowship:
        abbr: BS
        href: https://www.bsfinternational.org/
        description: Bible study resources and community.
    - Bookshare:
        abbr: BK
        href: https://www.bookshare.org/
        description: Accessible online library for people with print disabilities.
    - BARD:
        abbr: BD
        href: https://nlsbard.loc.gov/
        description: Braille and Audio Reading Download service for eligible users.
    - Audible:
        abbr: AU
        href: https://www.audible.com/
        description: Audiobook and spoken word entertainment service.

- Productivity:
    - CCU Library:
        abbr: CL
        href: https://www.ccu.edu/academics/library/
        description: Access CCU library resources for research and study.
    - ReadWorks:
        abbr: RW
        href: https://www.readworks.org/
        description: Reading passages and comprehension activities.
    - Perplexity AI:
        abbr: PA
        href: https://perplexity.ai/
        description: AI-powered search with detailed, conversational responses.

- Education:
    - Codecademy:
        abbr: CA
        href: https://www.codecademy.com/
        description: Interactive coding lessons for various languages.
    - NFB:
        abbr: NF
        href: https://nfb.org/
        description: Resources for Braille transcription and blind community.
    - Canvas:
        abbr: CV
        href: https://canvas.instructure.com/
        description: Learning management system for online courses.

- Gaming_Entertainment:
    - AudioGames:
        abbr: AG
        href: https://forum.audiogames.net/
        description: Community for audio-based and accessible games.
    - IncrementalDB:
        abbr: ID
        href: https://incrementaldb.com/
        description: Database of incremental games.
    - Galaxy Click:
        abbr: GC
        href: https://galaxy.click/
        description: Open-source website for finding incremental games.

- Shopping:
    - InnoSearch AI:
        abbr: IS
        href: https://innosearch.ai/
        description: Accessible e-commerce platform designed for blind users.
    - Amazon:
        abbr: AZ
        href: https://www.amazon.com/
        description: Online shopping platform with a wide range of products.
    - eBay:
        abbr: EB
        href: https://www.ebay.com/
        description: Online auction and shopping website.
    - Walmart:
        abbr: WM
        href: https://www.walmart.com/
        description: Online shopping platform with a wide range of products.
    - Best Buy:
        abbr: BB
        href: https://www.bestbuy.com/
        description: Online shopping platform for electronics and appliances.

services.yaml

---
- Automation:
    - Home Assistant:
        href: https://homeassistant.laniecarmelo.tech
        description: Home automation platform
        server: my-docker
        container: homeassistant
    - N8N:
        href: https://n8n.laniecarmelo.tech
        description: Workflow automation tool
        server: my-docker
        container: n8n
    - Ntfy:
        href: https://ntfy.laniecarmelo.tech
        description: Self-hosted notification service
        server: my-docker
        container: ntfy
- Communication:
    - Shlink:
        href: https://app.shlink.io
        description: URL shortener and link management
        server: my-docker
        container: shlink
    - TheLounge:
        href: https://irc.laniecarmelo.tech
        description: Web-based IRC client
- Developer:
    - Forgejo:
        href: https://git.laniecarmelo.tech
        description: My Git server
        widget:
            type: gitea
            url: https://git.laniecarmelo.tech
            key: redacted
    - PrivateBin:
        href: https://paste.laniecarmelo.tech
        description: Pastebin for sharing code snippets
- Information_Management:
    - Linkding:
        href: https://bookmarks.laniecarmelo.tech
        description: Self-hosted bookmark manager
        server: my-docker
        container: linkding
    - MiniFlux:
        href: https://rss.laniecarmelo.tech
        description: Self-hosted RSS feed reader
        widget:     
            type: miniflux
            url: https://rss.laniecarmelo.tech
            key: redacted
    - RSS-Bridge:
        href: https://rss-bridge.laniecarmelo.tech
        description: RSS feed generator for various websites
        server: my-docker
        container: rss-bridge
    - SearXNG:
        href: https://search.laniecarmelo.tech
        description: Self-hosted metasearch engine
    - Wallabag:
        href: https://read.laniecarmelo.tech
        description: Self-hosted read-it-later service
        server: my-docker
        container: wallabag
- Monitoring:
    - Beszel:
        href: https://beszel.laniecarmelo.tech
        description: Server monitoring and alerts
        widget:
            type: beszel
            url: https://beszel.laniecarmelo.tech
            version: 2
            username: redacted
            password: redacted
            systemId: redacted
    - Caddy:
        href: https://caddy.laniecarmelo.tech
        description: Reverse proxy and SSL management
        widget:
            type: caddy
            url: https://caddy.laniecarmelo.tech
    - Uptime Kuma:
        href: https://uptime.laniecarmelo.tech
        description: Uptime monitoring and status page
        server: my-docker
        container: uptime-kuma
        widget:
            type: uptimekuma
            url: https://uptime.laniecarmelo.tech
            slug: home
    - Watchtower:
        description: Docker container update monitoring
        server: my-docker
        container: watchtower
        widget:
            type: watchtower
            url: http://192.168.1.137:3014
            key: redacted
- Productivity:
    - Beaver Habit Tracker:
        href: https://habits.laniecarmelo.tech
        description: Habit tracking and productivity
        server: my-docker
        container: beaverhabits
    - Calendar:
        description: My Outlook calendar
        widget:
            type: calendar
            firstDayInWeek: sunday
            view: agenda
            showTime: true
            timezone: America/Chicago
            integrations:
                - type: ical
                  url: redacted
                  name: Outlook
    - Joplin Server:
        href: https://notes.laniecarmelo.tech
        description: Notes and knowledge management
        server: my-docker
        container: joplin_server
    - Mealie:
        href: https://recipes.laniecarmelo.tech
        description: Recipe management and meal planning
        server: my-docker
        container: mealie
        widget:
            type: mealie
            url: https://recipes.laniecarmelo.tech
            key: redacted
            version: 2
- Server_Management:
    - Cockpit:
        href: https://cockpit.laniecarmelo.tech
        description: Web-based server management interface
    - Dockge:
        href: https://dockge.laniecarmelo.tech
        description: Docker management interface
        server: my-docker
        container: stacks-dockge-1
    - Dozzle:
        href: https://dozzle.laniecarmelo.tech
        description: Docker container logs viewer
        server: my-docker
        container: dozzle
    - Tailscale (Raspberry Pi):
        href: https://login.tailscale.com
        description: Zero-config mesh VPN
        widget:
            type: tailscale
            deviceid: redacted
            key: redacted
    - Tailscale (Mini PC):
        href: https://login.tailscale.com
        description: Zero-config mesh VPN
        widget:
            type: tailscale
            deviceid: redacted
            key: redacted
    - Tailscale (iPhone):
        href: https://login.tailscale.com
        description: Zero-config mesh VPN
        widget:
            type: tailscale
            deviceid: redacted
            key: redacted
    - Tailscale (Google Pixel 9 Pro):
        href: https://login.tailscale.com
        description: Zero-config mesh VPN
        widget:
            type: tailscale
            deviceid: redacted
            key: redacted

settings.yaml

title: Stormux Dashboard
description: Links to and information about my self-hosted services and most-used sites
base: https://home.laniecarmelo.tech
theme: dark
language: en
target: _blank
quicklaunch:
  searchDescriptions: true
  showSearchSuggestions: true
  provider: custom
  url: https://search.laniecarmelo.tech/search?q=%s
  suggestionUrl: https://search.laniecarmelo.tech/autocompleter?q=%s

layout:
  # Assign each group to a tab
  Accessibility_Resources:
    tab: Accessibility_Resources
  Automation:
    tab: Automation
  Communication:
    tab: Communication
  Developer:
    tab: Developer
  Education:
    tab: Education
  Gaming_Entertainment:
    tab: Gaming_Entertainment
  Information_Management:
    tab: Information_Management
  Monitoring:
    tab: Monitoring
  Productivity:
    tab: Productivity
  Server_Management:
    tab: Server_Management
  Shopping:
    tab: Shopping

showStats: true

compose.yaml

services:
  homepage:
    image: ghcr.io/gethomepage/homepage:latest
    container_name: homepage
    ports:
      - 3000:3000
    volumes:
      - ./config:/app/config # Make sure your local config directory exists
      - /var/run/docker.sock:/var/run/docker.sock # (optional) For docker integrations
    environment:
      HOMEPAGE_ALLOWED_HOSTS: home.laniecarmelo.tech,192.168.1.137:3000,stormux:3000
      LOG_LEVEL: debug
    restart: unless-stopped

If you’ve encountered this issue before or have insights into resolving it, I’d greatly appreciate your help!

Hashtags:

#SelfHosting #HomepageDashboard #WebDev #Accessibility #YAML #Bookmarks #OpenSource

Thank you in advance!

@selfhosted @selfhost @selfhosting@slrpnk.net @selfhosting@a.gup.pe