{"id":13819642,"url":"https://github.com/tiredofit/docker-freescout","last_synced_at":"2026-04-26T09:05:07.020Z","repository":{"id":37759252,"uuid":"156040860","full_name":"tiredofit/docker-freescout","owner":"tiredofit","description":"Dockerized web based help desk and shared inbox","archived":false,"fork":false,"pushed_at":"2026-04-12T16:19:51.000Z","size":393,"stargazers_count":307,"open_issues_count":84,"forks_count":128,"subscribers_count":8,"default_branch":"main","last_synced_at":"2026-04-12T18:32:35.716Z","etag":null,"topics":["docker","helpdesk","laravel","php-fpm"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","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/tiredofit.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["tiredofit"]}},"created_at":"2018-11-04T02:02:56.000Z","updated_at":"2026-04-12T16:19:55.000Z","dependencies_parsed_at":"2023-02-16T11:01:37.245Z","dependency_job_id":"33eb85f1-f042-42f5-8396-224a943a7e1e","html_url":"https://github.com/tiredofit/docker-freescout","commit_stats":null,"previous_names":[],"tags_count":373,"template":false,"template_full_name":null,"purl":"pkg:github/tiredofit/docker-freescout","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tiredofit%2Fdocker-freescout","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tiredofit%2Fdocker-freescout/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tiredofit%2Fdocker-freescout/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tiredofit%2Fdocker-freescout/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tiredofit","download_url":"https://codeload.github.com/tiredofit/docker-freescout/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tiredofit%2Fdocker-freescout/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32291347,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T08:29:33.829Z","status":"ssl_error","status_checked_at":"2026-04-26T08:29:18.366Z","response_time":129,"last_error":"SSL_read: 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":["docker","helpdesk","laravel","php-fpm"],"created_at":"2024-08-04T08:00:51.153Z","updated_at":"2026-04-26T09:05:06.967Z","avatar_url":"https://github.com/tiredofit.png","language":"Dockerfile","funding_links":["https://github.com/sponsors/tiredofit","https://www.paypal.me/tiredofit"],"categories":["Dockerfile"],"sub_categories":[],"readme":"# github.com/tiredofit/docker-freescout\n\n[![GitHub release](https://img.shields.io/github/v/tag/tiredofit/docker-freescout?style=flat-square)](https://github.com/tiredofit/docker-freescout/releases/latest)\n[![Build Status](https://img.shields.io/github/actions/workflow/status/tiredofit/docker-freescout/main.yml?branch=main\u0026style=flat-square)](https://github.com/tiredofit/docker-freescout/actions)\n[![Docker Stars](https://img.shields.io/docker/stars/tiredofit/freescout.svg?style=flat-square\u0026logo=docker)](https://hub.docker.com/r/tiredofit/freescout/)\n[![Docker Pulls](https://img.shields.io/docker/pulls/tiredofit/freescout.svg?style=flat-square\u0026logo=docker)](https://hub.docker.com/r/tiredofit/freescout/)\n[![Become a sponsor](https://img.shields.io/badge/sponsor-tiredofit-181717.svg?logo=github\u0026style=flat-square)](https://github.com/sponsors/tiredofit)\n[![Paypal Donate](https://img.shields.io/badge/donate-paypal-00457c.svg?logo=paypal\u0026style=flat-square)](https://www.paypal.me/tiredofit)\n\n* * *\n\n## About\n\nThis will build a Docker Image for [FreeScout](https://freescout.net/) - An open source Helpscout / Zendesk alternative.\n\n* Automatically installs and sets up installation upon first start\n\n## Maintainer\n\n* [Dave Conroy](https://github.com/tiredofit)\n\n## Table of Contents\n\n* [About](#about)\n* [Maintainer](#maintainer)\n* [Table of Contents](#table-of-contents)\n* [Prerequisites and Assumptions](#prerequisites-and-assumptions)\n* [Installation](#installation)\n  * [Build from Source](#build-from-source)\n  * [Prebuilt Images](#prebuilt-images)\n* [Configuration](#configuration)\n  * [Quick Start](#quick-start)\n  * [Persistent Storage](#persistent-storage)\n  * [Environment Variables](#environment-variables)\n    * [Base Images used](#base-images-used)\n  * [Networking](#networking)\n* [Maintenance](#maintenance)\n  * [Shell Access](#shell-access)\n* [Support](#support)\n  * [Usage](#usage)\n  * [Bugfixes](#bugfixes)\n  * [Feature Requests](#feature-requests)\n  * [Updates](#updates)\n* [License](#license)\n* [References](#references)\n\n## Prerequisites and Assumptions\n\n* Assumes you are using some sort of SSL terminating reverse proxy such as:\n  * [Traefik](https://github.com/nfrastack/container-traefik)\n  * [Nginx](https://github.com/jc21/nginx-proxy-manager)\n  * [Caddy](https://github.com/caddyserver/caddy)\n* Requires access to a MySQL/MariaDB or Postgres Server\n\n## Installation\n\n### Build from Source\n\nClone this repository and build the image with `docker build -t (imagename) .`\n\n### Prebuilt Images\n\nBuilds of the image are available on [Docker Hub](https://hub.docker.com/r/tiredofit/freescout)\n\n```bash\ndocker pull docker.io/tiredofit/freescout:(imagetag)\n```\n\nBuilds of the image are also available on the [Github Container Registry](https://github.com/tiredofit/docker-freescout/pkgs/container/docker-freescout)\n\n```bash\ndocker pull ghcr.io/tiredofit/docker-freescout:(imagetag)\n```\n\nThe following image tags are available along with their tagged release based on what's written in the [Changelog](CHANGELOG.md):\n\n| Container OS | Tag       |\n| ------------ | --------- |\n| Alpine       | `:latest` |\n\n## Configuration\n\n### Quick Start\n\n* The quickest way to get started is using [docker-compose](https://docs.docker.com/compose/). See the examples folder for a working [compose.yml](examples/compose.yml) that can be modified for development or production use.\n\n* Set various [environment variables](#environment-variables) to understand the capabilities of this image.\n* Map [persistent storage](#persistent-storage) for access to configuration and data files for backup.\n* Make [networking ports](#networking) available for public access if necessary\n\n**The first boot can take from 2 minutes - 5 minutes depending on your CPU to setup the proper schemas.**\n\n* Login to the web server and enter in your admin email address, admin password and start configuring the system!\n\n### Persistent Storage\n\nThe following directories are used for configuration and can be mapped for persistent storage.\n\n| Directory                | Description                                                                                                              |\n| ------------------------ | ------------------------------------------------------------------------------------------------------------------------ |\n| `/www/logs`              | Nginx and PHP Log files                                                                                                  |\n| `/assets/custom`         | (Optional) Copy source code over existing source code in /www/html upon container start. Use exact file/folder structure |\n| `/assets/custom-scripts` | (Optional) If you want to execute custom scripting, place scripts here with extension `.sh`                              |\n| `/assets/modules`        | (Optional) If you want to add additional modules outside of the source tree, add them here                               |\n| `/www/html`              | (Optional) If you want to expose the Freescout sourcecode and enable Self Updating, expose this volume                   |\n| *OR*                     |                                                                                                                          |\n| `/data`                  | Hold onto your persistent sessions and cache between container restarts                                                  |\n\n### Environment Variables\n\n#### Base Images used\n\nThis image relies on an [Alpine Linux](https://hub.docker.com/r/tiredofit/alpine) or [Debian Linux](https://hub.docker.com/r/tiredofit/debian) base image that relies on an [init system](https://github.com/just-containers/s6-overlay) for added capabilities. Outgoing SMTP capabilities are handlded via `msmtp`. Individual container performance monitoring is performed by [zabbix-agent](https://zabbix.org). Additional tools include: `bash`,`curl`,`less`,`logrotate`,`nano`.\n\nBe sure to view the following repositories to understand all the customizable options:\n\n| Image                                                         | Description                            |\n| ------------------------------------------------------------- | -------------------------------------- |\n| [OS Base](https://github.com/tiredofit/docker-alpine/)        | Customized Image based on Alpine Linux |\n| [Nginx](https://github.com/tiredofit/docker-nginx/)           | Nginx webserver                        |\n| [PHP-FPM](https://github.com/tiredofit/docker-nginx-php-fpm/) | PHP Interpreter                        |\n\n| Parameter                              | Description                                                                                     | Default     | `_FILE` |\n| -------------------------------------- | ----------------------------------------------------------------------------------------------- | ----------- | ------- |\n| `ADMIN_EMAIL`                          | Administrator Email Address - Needed for logging in                                             |             | x       |\n| `ADMIN_FIRST_NAME`                     | Admin user First Name                                                                           | `Admin`     | x       |\n| `ADMIN_LAST_NAME`                      | Admin user First Name                                                                           | `User`      | x       |\n| `ADMIN_PASS`                           | Administrator Password - Needed for Logging in                                                  |             | x       |\n| `APPLICATION_NAME`                     | Change default application name - Default `Freescout`                                           | `freescout` |         |\n| `APP_PROXY`                            | Allow Application to use a proxy for fetching modules                                           |             |         |\n| `APP_TRUSTED_PROXIES`                  | Comma separated list of trusted proxies, i.e. `192.168.1.1,192.168.1.2,192.168.1.3`             |             |         |\n| `APP_SINCE_WITHOUT_QUOTES_ON_FETCHING` | Allow to disable quotes around SINCE date in IMAP search                                        | `FALSE`     |         |\n| `APP_X_FRAME_OPTIONS`                  | Allow to embed via iframes `TRUE` `FALSE` `DENY` `ALLOW FROM example.org`                       | `TRUE`      |         |\n| `DB_TYPE`                              | Type of the Database. Currently supported are `mysql` and `pgsql`                               | `mysql`     |         |\n| `DB_PGSQL_SSL_MODE`                    | Postgresql TLS Mode                                                                             | `prefer`    |         |\n| `DB_HOST`                              | Host or container name of the Databse Server e.g. `freescout-db`                                |             | x       |\n| `DB_PORT`                              | Database Port e.g.`3306` for mysql, `5432` for postgres                                         | `3306`      | x       |\n| `DB_NAME`                              | Database name e.g. `freescout`                                                                  |             | x       |\n| `DB_USER`                              | Username for above Database e.g. `freescout`                                                    |             | x       |\n| `DB_PASS`                              | Password for above Database e.g. `password`                                                     |             | x       |\n| `DB_SSL`                               | Used to enable SSL support for MySQL and MariaDB databases                                      | `FALSE`     |         |\n| `DISPLAY_ERRORS`                       | Display Errors on Website                                                                       | `FALSE`     |         |\n| `ENABLE_AUTO_UPDATE`                   | If coming from an earlier version of image, automatically update it to latest Freescout release | `TRUE`      |         |\n| `SETUP_TYPE`                           | Automatically edit configuration after first bootup `AUTO` or `MANUAL`                          | `AUTO`      |         |\n| `SITE_URL`                             | The url your site listens on example `https://freescout.example.com`                            |             |         |\n| `SKIP_STORAGE_PERMISSIONS`             | Skip applying permission to storage path, e.g. for instances involving large storage paths      | `FALSE`     |         |\n\n### Networking\n\nThe following ports are exposed.\n\n| Port | Description |\n| ---- | ----------- |\n| `80` | HTTP        |\n\n* * *\n\n## Maintenance\n\n### Shell Access\n\nFor debugging and maintenance purposes you may want access the containers shell.\n\n``bash\ndocker exec -it (whatever your container name is) bash\n``\n\n## Support\n\nThese images were built to serve a specific need in a production environment and gradually have had more functionality added based on requests from the community.\n\n### Usage\n\n* The [Discussions board](../../discussions) is a great place for working with the community on tips and tricks of using this image.\n\n* [Sponsor me](https://tiredofit.ca/sponsor) for personalized support\n\n### Bugfixes\n\n* Please, submit a [Bug Report](issues/new) if something isn't working as expected. I'll do my best to issue a fix in short order.\n\n### Feature Requests\n\n* Feel free to submit a feature request, however there is no guarantee that it will be added, or at what timeline.\n\n* [Sponsor me](https://tiredofit.ca/sponsor) regarding development of features.\n\n### Updates\n\n* Best effort to track upstream changes, More priority if I am actively using the image in a production environment.\n\n* [Sponsor me](https://tiredofit.ca/sponsor) for up to date releases.\n\n## License\n\nMIT. See [LICENSE](LICENSE) for more details.\n\n## References\n\n* \u003chttps://freescout.net/\u003e\n* \u003chttps://github.com/freescout-helpdesk/freescout/wiki/Installation-Guide\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftiredofit%2Fdocker-freescout","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftiredofit%2Fdocker-freescout","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftiredofit%2Fdocker-freescout/lists"}