Your self-hosted wall of website shortcuts.
One page with every useful site and its logo, plus a simple admin area to manage them.
- 🧱 Shortcut wall: large cards with logo, name and description; one click opens the site.
- 🔎 Instant search and sort: press / to search names, descriptions and domains; alphabetical or most recent order.
- 🖼️ Automatic logos: Fetch favicon finds the best icon a site offers, stores it in the app and downsizes it to 256 px, so the wall stays fast and never shows a broken image.
- 🛠️ Admin in dialogs: add, edit and delete without leaving the list; a deletion can be undone for 15 seconds.
- 💾 Export / import: one JSON file with every shortcut and its logos, to back up or move an install.
- 🌗 Light and dark themes, 🌐 French and English, 📱 mobile-friendly.
- 🏠 Internal sites too: shortcuts to your router, NAS or Proxmox on the local network, self-signed certificates included.
- 🔒 Secure by default: CSRF protection, strict CSP, login rate limiting, SSRF guard, refuses to start with default credentials.
ShortcutWall ships as a ready-to-use Docker image (linux/amd64 and linux/arm64, e.g. a Raspberry Pi):
ghcr.io/mrddream/shortcutwall. All you need is Docker with Compose.
mkdir shortcutwall && cd shortcutwallservices:
shortcutwall:
image: ghcr.io/mrddream/shortcutwall:latest
container_name: ShortcutWall
ports:
- "${PORT:-3050}:${PORT:-3050}"
# ADMIN_USER, ADMIN_PASS, SESSION_SECRET… come from .env (see .env.example):
# the app refuses to start in production without real values.
env_file:
- path: .env
required: false
environment:
NODE_ENV: production
PORT: ${PORT:-3050}
HOST: ${HOST:-0.0.0.0}
volumes:
- ./data:/app/data
- ./public/uploads:/app/public/uploads
restart: unless-stoppedThe container runs as an unprivileged user (uid 1000): create the folders yourself, otherwise Docker
creates them as root and the app can't write to them.
mkdir -p data public/uploadsprintf 'ADMIN_USER=admin\nADMIN_PASS=%s\nSESSION_SECRET=%s\n' 'choose-a-strong-password' "$(openssl rand -hex 32)" > .envReplace choose-a-strong-password with your own password. Every other setting is optional (see
Configuration).
docker compose up -dThe wall is available at http://localhost:3050 and the admin area at http://localhost:3050/admin.
docker compose pull && docker compose up -dTo stay on a given version, replace latest with a version number, for example
ghcr.io/mrddream/shortcutwall:1.2.2. The available versions are listed on the
releases page.
| Administration | Editing a website |
|---|---|
![]() |
![]() |
| Dark theme | On a phone |
![]() |
![]() |
All settings go in the .env file next to docker-compose.yml, then docker compose up -d to apply.
| Variable | Default | Description |
|---|---|---|
ADMIN_USER |
admin |
Admin login. |
ADMIN_PASS |
— | Admin password. Required: the app refuses to start with the default one. |
SESSION_SECRET |
— | Random secret of at least 32 characters (openssl rand -hex 32). Required. |
PORT |
3050 |
Port of the app (and of the published port). |
TRUST_PROXY |
false |
Set to true behind a reverse proxy (HTTPS, real client IP for the login rate limit). |
ALLOW_PRIVATE_NETWORKS |
true |
Lets you add sites hosted on your local network or VPN (192.168.x.x, 10.x.x.x, nas.lan…). Set to false if people you don't trust can reach the admin area. |
APP_NAME |
ShortcutWall |
Name shown in the header and page titles. |
APP_DEFAULT_LOCALE |
fr |
Default language: fr or en. |
SUPPORT_EMAIL / SUPPORT_PHONE |
— | Contacts shown in a "Need help?" dialog (hidden when empty). |
LOG_LEVEL |
info |
fatal, error, warn, info, debug or trace. |
- Wall (
/): public, no account needed. Click a card to open the site. - Admin (
/admin): Add a website, then Fetch favicon to get its logo automatically; click a tile to edit it. - Internal sites: enter the address the Docker host uses to reach them (
http://192.168.1.10:8080,https://nas.lan); self-signed certificates are accepted on the local network. - Backup: Export downloads
shortcutwall-YYYY-MM-DD.json(logos included); Import restores it, either merging it with the current sites or replacing them (that can be undone for 15 seconds). - Data: shortcuts live in
./data, logos in./public/uploads. Back up these two folders, or use Export.
- Admin password, session secret: required in production; sessions are only created on login.
- CSRF tokens on every form, strict Content-Security-Policy, cookies
HttpOnly/SameSite. - Login limited to 10 failed attempts per IP every 15 minutes.
- Outgoing requests (favicons, logos) can never reach loopback addresses (
127.0.0.1,::1) or cloud metadata endpoints, even through a redirect (SSRF guard). Local networks are allowed so internal sites can be added, which includes the Docker host's own network address; setALLOW_PRIVATE_NETWORKS=falseto block them too. Certificates are always verified for public sites. - Uploaded files are checked to really be images, and stored under generated names.
- The image runs as a non-root user, with the application code read-only.
- The container stops with
EACCES: permission denied: thedataorpublic/uploadsfolder belongs toroot. Fix it withsudo chown -R 1000:1000 data public/uploads, thendocker compose up -d. - It refuses to start ("Refusing to start in production…"):
ADMIN_PASSorSESSION_SECRETis missing, left at its default value, or the secret is shorter than 32 characters. Check the.envfile. - "The website is unreachable" for an internal site: the check runs from the container, so the site
must be reachable from the Docker host.
localhostmeans the container itself: use the host's network address instead (e.g.http://192.168.1.10:8080). - Logs:
docker compose logs -f.
Issues and pull requests are welcome. To build the image from the sources, use docker-compose-dev.yml:
docker compose -f docker-compose-dev.yml up -d --buildBefore opening a pull request, run the checks the CI runs (Node.js 26):
npm ci && npm run lint && npm run format:check && npm test


