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://
orhttps://
). - 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