Skip to content

Commit 7214380

Browse files
author
Mauricio Siu
committed
docs: add troubleshooting section for 404 errors with Templates and Compose Services
- Introduced guidance on resolving 404 errors related to Traefik routing for services created from templates and Docker Compose. - Explained the differences in routing configuration between Applications and Templates/Compose Services. - Provided a step-by-step solution for configuring domains and redeploying services to ensure changes take effect.
1 parent 1ce1036 commit 7214380

File tree

1 file changed

+31
-0
lines changed

1 file changed

+31
-0
lines changed

apps/docs/content/docs/core/troubleshooting.mdx

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -163,6 +163,37 @@ port: 3000
163163
1. Remove the healthcheck from the service
164164
2. Make sure the healthcheck is working
165165

166+
## Templates and Compose Services Returning 404
167+
168+
If you're experiencing 404 errors when accessing services created from templates (like Docker Registry, Stalwart, Uptime Kuma, etc.) or Docker Compose services, this is usually related to how Traefik handles routing for different service types.
169+
170+
### Understanding the Difference
171+
172+
Dokploy uses two different methods for configuring Traefik routing:
173+
174+
1. **Applications** (Nixpacks, Dockerfile, Buildpacks): Use the Traefik **file system** for routing configuration
175+
- Domain changes are applied automatically
176+
- No need to redeploy after updating domains
177+
- Configuration files are created in Traefik's dynamic configuration directory
178+
179+
2. **Templates and Compose Services**: Use Traefik **labels** for routing configuration
180+
- Require redeployment after any domain changes
181+
- Labels are read from Docker container metadata
182+
- Learn more about Traefik labels in the [official documentation](https://doc.traefik.io/traefik/reference/routing-configuration/other-providers/docker/#configuration-examples)
183+
184+
### Solution
185+
186+
When working with Templates or Compose services:
187+
188+
1. **Configure your domain** in the Domains section of your service
189+
2. **Redeploy the service** - This is crucial! The domain changes won't take effect until you redeploy
190+
3. Wait for the deployment to complete
191+
4. Your service should now be accessible via the configured domain
192+
193+
<Callout type='info'>
194+
**Key Tip:** Every time you add, modify, or remove a domain from a Template or Compose service, you must redeploy for the changes to take effect.
195+
</Callout>
196+
166197
## Getting "Bad Gateway Error" When Accessing Your Application Domain
167198

168199
If you're encountering a Bad Gateway Error when accessing your application through its domain, this typically indicates one of several common configuration issues:

0 commit comments

Comments
 (0)