Skip to content

Repository files navigation

🎫 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.

GitHub GitLab license Open Issues Open PRs Contributors donate sponsor

release build Last Commit StageFreight

GHCR Docker pulls Harbor

latest updated size latest-dev updated size

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:

php 8.3.33

Packages (apk):

c-client curl freetype gettext icu-libs krb5-libs libintl libjpeg-turbo libldap libpng libzip mariadb-client nginx oniguruma su-exec tini tzdata


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.

About

Rootless osTicket image running nginx and php-fpm under a minimal tini init on stock php:8.3-fpm-alpine — runs as uid 1000 and under arbitrary UIDs for hardened clusters, bundles the official and community plugin sets, and leaves cron to a separate scheduled job.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages