# imgpush

> imgpush is a minimalist self-hosted image service with a simple API for uploading, converting, and resizing user images like avatars, plus rate limiting and S3 storage.

- **Category:** Image Management
- **Licence:** MIT
- **Open source:** oss
- **Languages:** Python
- **Platforms:** Docker, Kubernetes
- **Tags:** API, Image Hosting, S3 Compatible, Rate Limiting, Kubernetes, Docker, Hacktoberfest, Image upload, Image resize, Images, Image api, Selfhosted, Image uploader, Picture, Avatar Service, Imagehost, Nudity Filter

## Description

imgpush is a lightweight self-hosted image hosting service for applications that accept user-uploaded images such as avatars. It provides a single API endpoint for uploads, automatically converts images to a chosen format, and resizes them on demand via URL parameters. The service includes per-IP rate limits, allowed-origin whitelisting, a liveness endpoint for health checks, and an authenticated delete API. Images are stored locally by default, with optional support for S3-compatible object storage using a local disk cache for fast serving. It runs as a Docker container on port 5000 and can be deployed to Kubernetes with the provided manifests. The project is open source under the MIT license with no paid tiers.

## Links

- [Homepage](https://github.com/hauxir/imgpush)
- [Docker](hauxir/imgpush)
- [GitHub Repository](https://github.com/hauxir/imgpush)

---
Source: https://selfhost.directory/project/imgpush