https://github.com/meysam81/default-backend
Minimal, zero-dependency, distroless docker container for a one-page HTML default backend, useful as the default rule for any load balancer.
https://github.com/meysam81/default-backend
404-page cloud-native container dark-mode default-backend devops distroless docker infrastructure ingress-controller kubernetes load-balancer minimal nginx responsive-design security-focused single-page static-site web-server zero-dependency
Last synced: 6 months ago
JSON representation
Minimal, zero-dependency, distroless docker container for a one-page HTML default backend, useful as the default rule for any load balancer.
- Host: GitHub
- URL: https://github.com/meysam81/default-backend
- Owner: meysam81
- License: mit
- Created: 2022-12-18T01:22:16.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-10-06T18:25:24.000Z (6 months ago)
- Last Synced: 2025-10-06T20:34:48.676Z (6 months ago)
- Topics: 404-page, cloud-native, container, dark-mode, default-backend, devops, distroless, docker, infrastructure, ingress-controller, kubernetes, load-balancer, minimal, nginx, responsive-design, security-focused, single-page, static-site, web-server, zero-dependency
- Language: HTML
- Homepage:
- Size: 207 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Default Backend
One-page HTML distroless docker container for default backend, useful as the default rule for any load balancer.
[](https://hub.docker.com/r/meysam81/default-backend)
[](https://hub.docker.com/r/meysam81/default-backend)
[](https://developer.mend.io/github/meysam81/default-backend)
[](https://github.com/meysam81/default-backend)
[](https://github.com/meysam81/default-backend)
[](https://github.com/meysam81/default-backend)
## Overview
A lightweight, security-focused 404 page served from a distroless container,
perfect for use as a default backend in load balancers and Kubernetes ingress
controllers.
Features dark mode support and responsive design while maintaining minimal
footprint.
## Features
- 🌓 Automatic dark/light mode based on system preferences
- 📱 Fully responsive design
- 🔒 Distroless container for minimal attack surface
- 🚀 Extremely lightweight (~2MB image size)
- 🎨 Clean, modern UI
- ⚡ Zero dependencies
- 🌐 System font stack for optimal performance
## Quick Start
```bash
docker run -dp 8000:8000 --name default-backend \
ghcr.io/meysam81/default-backend
```
Then visit http://localhost:8000
## Usage with Load Balancers
### Nginx
```nginx
server {
listen 80 default_server;
server_name _;
location / {
proxy_pass http://localhost:8000;
}
}
```
### Kubernetes Ingress
There's an officially supported Kustomization stack at the following URL:
## Security
- Built on Google's distroless container
- No shell access
- Minimal base image
- No external dependencies
- Regular security updates
## Development
To modify the page:
1. Edit the `public/index.html` file
2. Build the container:
```bash
docker build -t default-backend .
```
## License
Apache 2.0, see [LICENSE](LICENSE).
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## Support
- 🐛 [Report a bug](https://github.com/meysam81/default-backend/issues)
- 💡 [Request a feature](https://github.com/meysam81/default-backend/issues)
## Visual
The page looks like below:
