hlhd/osticket
Rootless container image for osTicket, the open-source support ticketing system.
10K+
hlhd/osticket repository overview
🎫 osticket
A rootless container image for osTicket — the open-source support-ticketing system. Runs unprivileged (uid 1000, arbitrary-UID capable): nginx + php-fpm under a minimal rootless init (tini); osTicket cron runs as a separate CronJob. Ships with the official and community plugin set bundled.
Documentation
| Topic | |
|---|---|
| Environment Variables | Full env reference — database, install/admin, SMTP, runtime, port |
Features
| Rootless | Runs as uid 1000 — and as any uid (OpenShift/hardened-cluster arbitrary-UID) |
| Minimal init | nginx + php-fpm under a minimal rootless init (tini); osTicket cron runs as a separate CronJob |
| Current | osTicket 1.18.x on stock php:8.3-fpm-alpine — no resurrected vendor base |
| Plugins bundled | Official set (LDAP, OAuth, storage) + community (Slack, Teams, Archiver, …) |
| Env-driven install | Idempotent first-boot install from env → multiple stateless replicas |
| Observability | Logs to stdout (Loki); php-fpm/nginx status endpoints (VictoriaMetrics) |
| Flexible port | HTTP_PORT (default 8080, rootless); 80 needs root or NET_BIND_SERVICE |
Image contents
Base image & installed packages (click to expand)
Base Image:
Packages (apk):
Installation
Pull the image (ghcr primary, Docker Hub mirror) or build it yourself:
docker pull ghcr.io/homelabhd/osticket:latest
# or
docker pull docker.io/hlhd/osticket:latest
git clone https://github.com/HomeLabHD/osticket
cd osticket
docker build -t hlhd/osticket .
osTicket needs a MySQL/MariaDB database and is configured entirely from the environment — see Environment Variables. The container serves on HTTP_PORT (default 8080); front it on 80/443 at your ingress/Service.
Contributing
- Fork the repository
- Submit Pull Requests / Merge Requests
- File issues with image tag, run/compose command, and environment details
Credits
- Powered by osTicket — the actively-maintained open-source ticketing system
Disclaimer
The Software provided hereunder ("Software") is licensed "as-is," without warranties of any kind — express, implied, or telepathically transmitted. The developer makes no promises about functionality, performance, compatibility, security, or availability. Not liable if your help desk becomes self-aware and starts closing your tickets as "won't fix," if env-driven auto-install summons an admin account you didn't ask for, or if running it rootless gives you such a smug sense of security that you forget to back up your database.
Any positive experiences are owed entirely to the brilliant folks behind osTicket and the unstoppable force that is the Open Source community. The developer claims no credit for anything that actually goes right.
License
osTicket is distributed under the GPL-2.0 license. This packaging is maintained by HomeLabHD.
Tag summary
Content type
Image
Digest
sha256:d115c1a73…
Size
168.5 MB
Last updated
6 days ago
docker pull hlhd/osticket