{"id":19811246,"url":"https://github.com/stiks/defaultbackend-rest","last_synced_at":"2026-05-18T19:33:30.518Z","repository":{"id":68748788,"uuid":"112352529","full_name":"stiks/defaultbackend-rest","owner":"stiks","description":"Kubernetes Default Backend REST","archived":false,"fork":false,"pushed_at":"2017-11-28T16:51:09.000Z","size":7,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-09-09T21:10:01.671Z","etag":null,"topics":["default-backend","go","ingress","kubernetes"],"latest_commit_sha":null,"homepage":null,"language":"Go","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/stiks.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-11-28T15:23:16.000Z","updated_at":"2019-03-13T09:48:33.000Z","dependencies_parsed_at":"2023-05-09T10:31:50.938Z","dependency_job_id":null,"html_url":"https://github.com/stiks/defaultbackend-rest","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/stiks/defaultbackend-rest","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stiks%2Fdefaultbackend-rest","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stiks%2Fdefaultbackend-rest/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stiks%2Fdefaultbackend-rest/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stiks%2Fdefaultbackend-rest/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stiks","download_url":"https://codeload.github.com/stiks/defaultbackend-rest/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stiks%2Fdefaultbackend-rest/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33188535,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-18T09:27:30.708Z","status":"ssl_error","status_checked_at":"2026-05-18T09:27:28.300Z","response_time":71,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["default-backend","go","ingress","kubernetes"],"created_at":"2024-11-12T09:25:30.993Z","updated_at":"2026-05-18T19:33:30.495Z","avatar_url":"https://github.com/stiks.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Default Backend Server\n\nThis is a simple webserver that satisfies the ingress, which means it has to do two things:\n\n 1. Serves a 404 page at `/`\n 2. Serves 200 on a `/healthz`\n\nServer respond JSON instead of plain text\n\nNot found page:\n```\n$ curl http://localhost:8080\n{\"code\":404,\"message\":\"Not found\"}\n```\n\nStatus page:\n\n```\n$ curl http://localhost:8080/healthz\n{\"status\":\"ok\"}\n```\n\n## Why?!\n\nIn my projects, it's important that alive server respond JSON, even if this is default backend server. This image is only 2mb which is extreamly small compare to others custom error images.\n\nAlso I personally think JSON response looks better than html error without formatting\n\nExample usage:\n```\napiVersion: extensions/v1beta1\nkind: Deployment\nmetadata:\n  name: default-http-backend\n  labels:\n    app: default-http-backend\n  namespace: ingress-nginx\nspec:\n  replicas: 1\n  template:\n    metadata:\n      labels:\n        app: default-http-backend\n    spec:\n      terminationGracePeriodSeconds: 60\n      containers:\n      - name: default-http-backend\n        image: stiks/defaultbackend-rest:1.0\n        livenessProbe:\n          httpGet:\n            path: /healthz\n            port: 8080\n            scheme: HTTP\n          initialDelaySeconds: 30\n          timeoutSeconds: 5\n        ports:\n        - containerPort: 8080\n        resources:\n          limits:\n            cpu: 10m\n            memory: 20Mi\n          requests:\n            cpu: 10m\n            memory: 20Mi\n---\napiVersion: v1\nkind: Service\nmetadata:\n  name: default-http-backend\n  namespace: ingress-nginx\n  labels:\n    app: default-http-backend\nspec:\n  type: NodePort\n  ports:\n  - port: 80\n    targetPort: 8080\n    protocol: TCP\n  selector:\n    app: default-http-backend\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstiks%2Fdefaultbackend-rest","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstiks%2Fdefaultbackend-rest","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstiks%2Fdefaultbackend-rest/lists"}