The Tool Desk
Outbyte Driver Updater FREEFix the driver behind crashes, sound loss and screen glitchesFind Drivers →Outbyte PC Repair FREERepair Windows errors before they cause bigger problemsFix Now →The reliable pattern is to publish Uptime Kuma on its own hostname, connect its container to the Docker network used by Traefik, and route HTTPS traffic to port 3001. Keep Uptime Kuma’s /app/data directory on a local, POSIX-lock-capable filesystem, and preserve WebSocket upgrades. A subdirectory URL such as https://example.com/uptimekuma is not supported.
Need a server to try this on? Antihost offers Linux VPS plans with NVMe storage, full root access and a 14-day free trial.
What the finished deployment looks like
Uptime Kuma listens inside its container on TCP port 3001. Traefik receives requests on its HTTPS entrypoint, matches a hostname rule, terminates TLS, and forwards the request to that container port. Uptime Kuma stores its SQLite-backed application data under /app/data, which should be persisted with a bind mount or volume.
As an Amazon Associate I earn from qualifying purchases.
Do these 3 things before closing this tab:
1Repair Windows errors before they cause bigger problems2Fix the driver behind crashes, sound loss and screen glitches3Clear out junk files and repair common Windows errorsThe public URL should be a dedicated host, for example status.example.com. Create DNS for that name, point it at the server running Traefik, and use the same name in the Traefik Host(...) rule. Uptime Kuma’s reverse-proxy guidance explicitly says subdirectory deployments are unsupported, so a path prefix is not an alternative.
Prerequisites and design decisions
- Docker Engine with the Compose plugin, so
docker composeis available. - An existing Traefik deployment with an HTTPS entrypoint and a certificate resolver. The names in your labels must exactly match Traefik’s static configuration.
- A DNS record for the hostname you will put in the
Host(...)rule. - A Docker network that both Traefik and Uptime Kuma can reach. The network name is deployment-specific; use the actual shared network rather than assuming a particular name.
- A persistent data location that supports local/POSIX file locking. The installation guidance warns that unsupported filesystems such as NFS can lead to SQLite corruption.
Decide whether Uptime Kuma also needs to be reachable directly on the host. If Traefik is the only public entry point, you can omit the host-port mapping and expose the service only to the shared Docker network. If you need direct access for initial setup or emergency diagnostics, retain the mapping, but protect that port with your firewall.
#1 Best Overall
- BLUE LIGHT BLOCKING GLASSES: Our blue light glasses for women boast UV400 protection, blocking harmful blue rays from computer screens. With these bluelight glasses women, you can enjoy gaming, reading, or watching TV with no worries of eye strain.
- EYE RELIEF: Our blue light glasses are engineered to reduce blurry vision or strain caused by prolonged screen time. These womens blue light glasses aid in better sleep by preventing blue light from disrupting your natural sleep cycle, helping you fall asleep faster and enjoy a more restful night's sleep, making them the perfect christmas present.
- COMFORTABLE: Crafted from durable material, our trendy blue light glasses for woman or blue light glasses men ensure long-lasting comfort. The high-transmittance lenses accessories, gamer gifts for men, help keep your eyes relaxed. Perfect stocking stuffers, gifts for gamers men, christmas gifts for men, halloween costumes.
- LIGHTWEIGHT: These clear blue light glasses feature a lightweight frame, meaning they’ll stay comfy for long-term wear. Perfect as blue blockers glasses for women or mens blue light glasses, these non-prescription fake glasses for men can be worn throughout the day. The blue light blocking glasses women feature polycarbonate HD lenses, which are anti-reflective and restore true color.
- WORRY-FREE PURCHASE: If you experience any issues, our support team is ready to assist you quickly. These are the perfect costume glasses for cosplay dressing up.
Minimal Compose service
This is the project’s basic Compose shape. It publishes port 3001 on the Docker host and persists data in a directory beside the Compose file.
services:
uptime-kuma:
image: louislam/uptime-kuma:2
restart: unless-stopped
volumes:
- ./data:/app/data
ports:
- "3001:3001"Save it as compose.yml (or another Compose filename), create the data directory, and start it:
Outdated Drivers Are Slowing You Down
One free scan finds every outdated or missing driver and matches the right update for your exact hardware.Free scan · exact hardware matchPC Slower Than It Used to Be?
A free scan shows the junk files, broken settings and background clutter dragging Windows down - then fixes them in one click.Free scan · Windows 10 & 11Rank #2
- WINDEX GAMING WIPES: effortlessly clean all your gaming gear and gaming electronics in one easy step with our new Windex Gaming Wipes
- AMMONIA FREE: our ammonia-free formula is safe to use on all of your favorite gaming equipment like consoles, headsets, controllers, screens, keyboards, and more
- PRE-MOISTENED WIPES: each wipe instantly removes dust, dirt, and stubborn smudges and fingerprints leaving a streak-free shine
- ANTI-STATIC: great for cleaning and wiping down your gaming gear and electronics leaving behind no visible residue
- COMPACT RESEALABLE PACKAGE: store your pack of Windex Gaming Wipes anywhere in your home for whenever a quick and easy wipedown is needed
mkdir -p data
docker compose up -dThe restart: unless-stopped policy brings the container back after a Docker or host restart unless you explicitly stop it. The image tag shown above follows the current official example’s major-version tag. Pin a different tag only if that matches your own upgrade policy.
Compose variant for Traefik-only access
When Traefik already provides the public entrypoint, attach Uptime Kuma to Traefik’s network and omit ports. In this example, traefik-public is a placeholder: replace it with the real network name used by your Traefik container.
Rank #3
- Ergonomic & Adjustable Design: Fight "text neck" and improve your posture. Designed for comfort, it offers an adjustable height (7.1in-8.5in) (1.4in adjustable range) and angle (5°-85°) Please note: cell phone stand is only 9 inches tall—the length of a standard pencil
- Without blocking subtitles Perfect for office desk Tiktok Face Time Zoom video—this is the ultimate kitchen desk essential for phones! Perfect viewing experience while reducing neck back strain, A must-have for gamers streamers desk, and anyone who values both style and support!
- Sleek & Stable Design fits Otterbox Case: Say goodbye to bent cables, tangles, and tip-overs! LISEN’s stylish adjustable desk phone holder features a built-in charging hole and smart cable management, keeping your phone secure and your workspace clutter-free cool gadgets for men
- ANTI-SLIP DESIGN free hands: The under 10.00 items easy gadgets back and the bottom of this kitchen essentials for women are fully covered by anti-skid silicone, which LISEN stand up desk decor can provide maximum protection device from any scratches and slides
- Your Perfect Viewing Companion:If your product arrives damaged or breaks within 365 days, reach out to LISEN for a quick and hassle-free solution. Struggling with assembly, like tightening the screw? We’ve got your back! Your experience matters to us. (Product including: phone Holder stand*1, screw*1, hexagon screwdriver*1, specification*1)
services:
uptime-kuma:
image: louislam/uptime-kuma:2
restart: unless-stopped
volumes:
- ./data:/app/data
networks:
- traefik-public
labels:
- "traefik.enable=true"
- "traefik.http.routers.uptime-kuma.rule=Host(`status.example.com`)"
- "traefik.http.routers.uptime-kuma.entrypoints=https"
- "traefik.http.routers.uptime-kuma.tls=true"
- "traefik.http.routers.uptime-kuma.tls.certresolver=myresolver"
- "traefik.http.services.uptime-kuma.loadBalancer.server.port=3001"
networks:
traefik-public:
external: trueUse an external network declaration only when that network already exists outside this Compose project. If your setup creates the shared network in the same project, use the network definition required by that deployment instead. The important condition is reachability between the Traefik and Uptime Kuma containers.
What each Traefik label does
| Label | Purpose | Value to change |
|---|---|---|
traefik.enable=true |
Opts this container into Traefik’s Docker provider. | Normally unchanged. |
traefik.http.routers.uptime-kuma.rule=Host(...) |
Matches requests for one hostname. | Replace status.example.com with your DNS name. |
traefik.http.routers.uptime-kuma.entrypoints=https |
Binds the router to Traefik’s HTTPS entrypoint. | Use your configured entrypoint name if it is not https. |
traefik.http.routers.uptime-kuma.tls=true |
Enables TLS on this router. | Normally unchanged for HTTPS. |
traefik.http.routers.uptime-kuma.tls.certresolver=myresolver |
Selects the certificate resolver that obtains the certificate. | Replace myresolver with the resolver name in Traefik’s static configuration. |
traefik.http.services.uptime-kuma.loadBalancer.server.port=3001 |
Forces Traefik to send traffic to Uptime Kuma’s internal port. | Keep 3001; this is Uptime Kuma’s service port. |
The explicit service-port label matters because it overrides automatic port detection. It also avoids ambiguity when the container has more than one exposed port or when no host-port mapping exists.
Recommended Free Tools
Rank #4
- Easy Installation: Our gaming lights have been designed to enhance your entertainment experience. Simply position the led light bar next to your TV or game console to create a game room environment with ease. They come with USB power and a 60 inch cord for direct mounting and mobility
- Audio Syncing & Extensive Mode: The built-in high-sensitivity music sensor allows you to sync the TV led lights to your favorite music. Lights react and move to the beat of music, film and game audio, creating an incredible immersive sound and light experience – and all without the need for an additional hub. You can choose from 64+ patterns, including strobe, illusion, jump, energy, gradient, running, chasing, fluttering mode etc. Each mode can be applied to different scenes
- 64+ Chasing IC+RGB & W Effect: The independent control design of IC+RGB and white all-in-one multifunctional rgbw led bar lights monitor backlight allows you to easily switch the led lights for desk between IC+RGB and white to enjoy a variety of lighting effects, you can choose white lighting mode with high brightness for better illumination when working, etc. Choose IC+RGB lighting mode when you need to create an entertaining atmosphere for the light show, 16 million colours of Color changing rgb light bar let you dance to the beat and create a dynamic party atmosphere
- Dynamic and Dimmable Lights: 1%-full brightness free brightness adjustment gives you the flexibility to adjust dimmable led light bar for room decorations or a variety of occasions
- USB Powered: USB light bars for room can be powered by powernank, usb charger, TV, Monitor, laptop PC mainframe, making behind TV led lighting bar easy to install in any location.TV led lights are powered by the TV usb interface / PC mainframe, can be turned on/off synchronously with TV / PC
Bring the stack online
- Prepare storage. Create
./datanext to the Compose file, or select a Docker volume backed by a filesystem that supports POSIX locking. Do not place the SQLite data directory on an unsupported NFS mount. - Choose the network. Determine the network attached to Traefik with your normal Docker inspection workflow, then put that exact name in the Uptime Kuma service’s
networkssection. - Set the hostname and resolver. Edit the
Host(...)value and certificate-resolver label. The hostname must have DNS pointing to the Traefik host, and the resolver name must match Traefik’s configured resolver exactly. - Start or recreate the service. Run
docker compose up -d. If you changed labels or networks, Compose will recreate the container as needed. - Watch startup output. Use
docker compose logs -f uptime-kumafor application logs and the equivalent Traefik log command for router, network, or certificate errors. - Open the HTTPS hostname. Visit the complete host over HTTPS, not a path such as
/uptimekuma. Complete Uptime Kuma’s first-run setup in the browser.
WebSockets: the part that ordinary HTTP checks miss
Uptime Kuma is WebSocket-based. Its official reverse-proxy guidance states that a proxy must handle the Upgrade and Connection headers so the WebSocket handshake can complete. Traefik’s HTTP routing must therefore be functioning as a WebSocket-capable reverse proxy, not merely returning the initial HTML page.
A deployment can appear healthy while still being broken: the login page may load, but live monitor updates, connection status, or other real-time behavior can fail. After opening the site, keep the browser developer console and network panel available and check the proxy logs if the WebSocket connection closes or never upgrades. First verify that Traefik reaches the container on the shared network; then inspect any proxy middleware or entrypoint configuration that could remove upgrade handling.
Best Value
- Compatible with Wide Screens - To ensure compatibility with the dual monitor mount, your each monitor must meet three conditions at the same time: First, computer screens size range: 13 to 32 inches. Second, screen weight range: 4.4 to 19.8 lbs. Third, the back of the monitor screen must have VESA mounting holes with a pitch of 75x75mm or 100x100mm.
- Regarding the compatibility with desks - Your desk must meet three conditions at the same time: First, desk material: Only wooden desks are recommended, plastic or glass desks cannot be used. Second, desk thickness range: 0.59" - 3.54". Third, the bottom of the desk should not have any cross beams or panels, as this will interfere with installation. We recommend carefully checking that your desk and monitors meets all above conditions before purchasing.
- Dual C-Clamp Hold - Worried your dual monitors might wobble or slip? Our upgraded base uses a larger platform plus a dual C-clamp structure to lock the dual monitor arm firmly to your desk. Each arm safely keeps your screens steady while you type, click and game—no shaking, no sliding, just a clean and secure setup you can trust every day. It also provides Grommet Mounting installation choice, both options ensure stable and secure fixation for your 0.59" - 3.54" desk.
- Full-Motion Adjustment For Comfortable View - Pull the screen closer when you’re deep in a spreadsheet, push it back to watch videos, or rotate to portrait for coding — moving everything smoothly with just one hand. The monitor stand offers +85°/-50° tilt, ±90° swivel and 360° rotation. Raise your monitor up to 15.75″ to support a healthy sitting posture. Whether you’re working from home, gaming through the night, or switching between video calls and documents, getting the screens to your natural line of sight helps relieve neck, shoulder and back strain so you can stay focused longer with less fatigue.
- Keep Your Desk Organized: By lifting both screens off the desktop, this dual monitor stand opens up valuable space for your keyboard, notebook, docking station or a simple, clutter-free work area. Built-in cable management guides wires along the arms, keeping cords out of sight and out of the way. Enjoy a tidy, modern workstation that looks as good as it feels to use.
Forwarded headers and the Trust Proxy setting
When Uptime Kuma is completely behind Traefik and firewall rules prevent users from bypassing the proxy, you can enable Settings → Reverse Proxy → HTTP Headers → Trust Proxy. This allows Uptime Kuma to trust forwarded headers from the proxy so the client IP is represented correctly in logs.
Only enable that setting when direct access is restricted to the trusted proxy path. If users can reach the application through an untrusted route, accepting forwarded headers from arbitrary clients can make logged client information unreliable.
HTTPS and certificate issuance
The TLS labels tell Traefik to terminate HTTPS for the hostname and use the selected certificate resolver. Certificate acquisition still depends on the resolver’s own static configuration and on the hostname resolving to the server where Traefik can answer the challenge. A label cannot repair a misspelled entrypoint, resolver, or DNS record.
| Check | Expected condition | If it fails |
|---|---|---|
| DNS | The status hostname resolves to the Traefik server. | Correct the DNS record before debugging Uptime Kuma. |
| Entrypoint | The label uses the exact HTTPS entrypoint name configured in Traefik. | Change the label or Traefik configuration so the names match. |
| Resolver | The certificate-resolver label names an existing resolver. | Use the configured resolver name and inspect Traefik’s certificate logs. |
| Backend | Traefik can connect to the Uptime Kuma container on port 3001. | Fix the shared Docker network or service-port label. |
Troubleshooting by symptom
The browser returns a gateway or “server unavailable” error
- Confirm the container is running with
docker compose ps. - Check that Traefik and Uptime Kuma share a reachable Docker network.
- Verify the service label points to port
3001, not the host port or an unrelated container port. - Inspect Traefik logs for a router that was not created because a label, entrypoint, or network reference is invalid.
The page loads but real-time updates do not work
- Treat this as a WebSocket problem first: confirm the request reaches the HTTPS router and that the upgrade flow is preserved.
- Check browser developer tools for a failed WebSocket handshake or immediate disconnect.
- Review Traefik logs and verify the backend remains reachable on port 3001.
Traefik serves the wrong certificate or no certificate
- Compare the requested hostname with the
Host(...)rule character for character. - Confirm DNS points to the Traefik host and that the HTTPS entrypoint is the one receiving traffic.
- Check that the resolver name in the label exactly matches the static resolver configuration.
Uptime Kuma starts, then data behaves unreliably
- Check where
./datais mounted. It must be persistent and support POSIX-style file locking. - Move the data directory off an unsupported filesystem such as NFS before relying on the instance for monitoring history and settings.
- Do not delete the data directory as a first troubleshooting step; that removes the persisted application state.
The hostname works only when a host port is published
Publishing 3001:3001 is not required for Traefik-to-container traffic when both services share a Docker network. If removing the mapping breaks the route, the likely issue is network reachability or an incorrect service-port label, not the absence of a host mapping. Recheck the network attachment and keep the explicit backend port set to 3001.
Deployment choices at a glance
| Choice | Hostname routing | HTTPS automation | WebSockets | Network exposure | Persistence concern |
|---|---|---|---|---|---|
| Compose with host port and Traefik | Dedicated host recommended | Traefik resolver handles the certificate when configured | Must pass upgrade and connection handling | Port 3001 is also exposed on the host | Use a lock-capable persistent /app/data |
| Compose on shared Traefik network without host port | Dedicated host required | Traefik resolver handles the certificate when configured | Must pass upgrade and connection handling | Only Traefik needs public access; backend stays on Docker network | Use a lock-capable persistent /app/data |
| Subdirectory URL | Not supported by Uptime Kuma | Not applicable as a supported layout | Not a supported deployment pattern | Not applicable | Not applicable |
Pre-launch checklist
- The DNS record resolves to the Traefik host.
- The
Host(...)rule uses that exact hostname. - The HTTPS entrypoint and certificate-resolver names match Traefik’s static configuration.
- The Uptime Kuma container is attached to the same reachable Docker network as Traefik.
- The backend label selects port
3001. ./data(or the chosen volume) is persistent and stored on a local/POSIX-lock-capable filesystem.- The site opens over HTTPS and the browser establishes a WebSocket connection for live behavior.
- If the application is fully shielded from direct access, Trust Proxy is enabled at Settings → Reverse Proxy → HTTP Headers → Trust Proxy when accurate client IP logging is required.
With those conditions met, Traefik can terminate HTTPS on the dedicated hostname and forward both ordinary HTTP requests and Uptime Kuma’s WebSocket traffic to the container on port 3001, while the persisted data directory protects the instance across recreations.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
