You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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.
Copy file name to clipboardExpand all lines: apps/docs/content/docs/core/troubleshooting.mdx
+31Lines changed: 31 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -163,6 +163,37 @@ port: 3000
163
163
1. Remove the healthcheck from the service
164
164
2. Make sure the healthcheck is working
165
165
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
+
166
197
## Getting "Bad Gateway Error" When Accessing Your Application Domain
167
198
168
199
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