{"id":13582617,"url":"https://github.com/pascaliske/docker-traefik-errors","last_synced_at":"2025-04-06T04:35:32.294Z","repository":{"id":39414804,"uuid":"379882680","full_name":"pascaliske/docker-traefik-errors","owner":"pascaliske","description":"Custom error pages for your traefik installation.","archived":false,"fork":false,"pushed_at":"2025-03-12T19:06:24.000Z","size":3102,"stargazers_count":4,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-21T17:23:54.654Z","etag":null,"topics":["docker","traefik","traefik-middleware"],"latest_commit_sha":null,"homepage":"https://pascaliske.github.io/docker-traefik-errors/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pascaliske.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-06-24T10:10:14.000Z","updated_at":"2025-03-12T19:05:59.000Z","dependencies_parsed_at":"2023-10-22T06:19:02.368Z","dependency_job_id":"6654e943-dee6-44c3-af05-e0d0f03656a4","html_url":"https://github.com/pascaliske/docker-traefik-errors","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":"pascaliske/docker-package","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pascaliske%2Fdocker-traefik-errors","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pascaliske%2Fdocker-traefik-errors/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pascaliske%2Fdocker-traefik-errors/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pascaliske%2Fdocker-traefik-errors/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pascaliske","download_url":"https://codeload.github.com/pascaliske/docker-traefik-errors/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247435041,"owners_count":20938530,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","traefik","traefik-middleware"],"created_at":"2024-08-01T15:02:53.062Z","updated_at":"2025-04-06T04:35:32.048Z","avatar_url":"https://github.com/pascaliske.png","language":"HTML","readme":"# [`pascaliske/docker-traefik-errors`](https://pascaliske.github.io/docker-traefik-errors/)\n\n\u003e Custom error pages for your traefik installation.\n\n[![Docker Image Version (tag latest semver)](https://img.shields.io/docker/v/pascaliske/traefik-errors/latest?style=flat-square)](https://hub.docker.com/r/pascaliske/traefik-errors) [![Docker Image Size (tag)](https://img.shields.io/docker/image-size/pascaliske/traefik-errors/latest?style=flat-square)](https://hub.docker.com/r/pascaliske/traefik-errors) [![Docker Pulls](https://img.shields.io/docker/pulls/pascaliske/traefik-errors?style=flat-square)](https://hub.docker.com/r/pascaliske/traefik-errors) [![GitHub Tag](https://img.shields.io/github/v/tag/pascaliske/docker-traefik-errors?style=flat-square)](https://github.com/pascaliske/docker-traefik-errors) [![Build Status](https://img.shields.io/github/workflow/status/pascaliske/docker-traefik-errors/Image/main?label=build\u0026style=flat-square)](https://github.com/pascaliske/docker-traefik-errors/actions) [![GitHub Last Commit](https://img.shields.io/github/last-commit/pascaliske/docker-traefik-errors?style=flat-square)](https://github.com/pascaliske/docker-traefik-errors) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](https://opensource.org/licenses/MIT) [![Awesome Badges](https://img.shields.io/badge/badges-awesome-green.svg?style=flat-square)](https://github.com/Naereen/badges)\n\n## Image\n\n| Registry   | Image                                                                                                                    |\n| ---------- | ------------------------------------------------------------------------------------------------------------------------ |\n| Docker Hub | [`pascaliske/traefik-errors`](https://hub.docker.com/r/pascaliske/traefik-errors)                                        |\n| GitHub     | [`ghcr.io/pascaliske/traefik-errors`](https://github.com/pascaliske/docker-traefik-errors/pkgs/container/traefik-errors) |\n\nThe following platforms are available for this image:\n\n```bash\n$ docker run --rm mplatform/mquery pascaliske/traefik-errors:latest\nImage: pascaliske/traefik-errors:latest\n * Manifest List: Yes\n * Supported platforms:\n   - linux/amd64\n   - linux/arm/v7\n   - linux/arm64\n```\n\n## Usage\n\nTo use the error pages you have to do these two steps:\n\n### 1. Setup error service\n\nThe easiest way to use the service is `docker-compose`:\n\n```yaml\nversion: '3.7'\nservices:\n  # proxy\n  traefik:\n    image: traefik:latest\n    container_name: traefik\n    ports:\n      - '80:80'\n    command:\n      - --providers.docker=true\n      - --providers.docker.exposedbydefault=false\n      - --entrypoints.http.address=:80\n    volumes:\n      - /var/run/docker.sock:/var/run/docker.sock:ro\n      - /path/to/traefik/config:/etc/traefik\n\n  # custom error pages\n  traefik-errors:\n    image: ghcr.io/pascaliske/traefik-errors:latest # or: pascaliske/traefik-errors:latest\n    container_name: traefik-errors\n    labels:\n      - traefik.enable=true\n      - traefik.http.routers.traefik-errors.rule=HostRegexp(`{host:.+}`)\n      - traefik.http.routers.traefik-errors.entrypoints=http\n      - traefik.http.routers.traefik-errors.priority=1\n      - traefik.http.routers.traefik-errors.middlewares=error-pages@file\n\n  # demo service\n  whoami:\n    image: traefik/whoami\n    container_name: whoami\n    labels:\n      - traefik.enable=true\n      - traefik.http.routers.whoami.rule=Host(`whoami.domain.tld`)\n      - traefik.http.routers.whoami.entrypoints=http\n      - traefik.http.routers.whoami.middlewares=error-pages@file\n```\n\n### 2. Configure traefik middleware\n\nCreate a dynamic config file for traefik:\n\n```yaml\nhttp:\n  middlewares:\n    error-pages:\n      errors:\n        service: traefik-errors\n        query: \"/?code={status}\u0026home=domain.tld\" # home parameter is optional\n        status:\n          - 400-599\n```\n\n## Kubernetes\n\nIf you want to use this tool inside of a Kubernetes cluster [check out my ready to deploy Helm chart](https://charts.pascaliske.dev/charts/traefik-errors/?utm_source=GitHub\u0026utm_medium=Repository\u0026utm_campaign=docker-traefik-errors)!\n\n## License\n\n[MIT](LICENSE.md) – © 2023 [Pascal Iske](https://pascaliske.dev)\n","funding_links":[],"categories":["HTML"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpascaliske%2Fdocker-traefik-errors","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpascaliske%2Fdocker-traefik-errors","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpascaliske%2Fdocker-traefik-errors/lists"}