{"id":49852976,"url":"https://github.com/nfrastack/container-freescout","last_synced_at":"2026-05-23T09:03:32.510Z","repository":{"id":37759252,"uuid":"156040860","full_name":"nfrastack/container-freescout","owner":"nfrastack","description":"Containerized web based help desk and shared inbox","archived":false,"fork":false,"pushed_at":"2026-05-12T05:46:40.000Z","size":445,"stargazers_count":315,"open_issues_count":85,"forks_count":128,"subscribers_count":8,"default_branch":"main","last_synced_at":"2026-05-12T07:10:45.502Z","etag":null,"topics":["helpdesk","laravel","php-fpm"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":false,"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/nfrastack.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-05-12T05:46:32.000Z","dependencies_parsed_at":"2023-02-16T11:01:37.245Z","dependency_job_id":"33eb85f1-f042-42f5-8396-224a943a7e1e","html_url":"https://github.com/nfrastack/container-freescout","commit_stats":null,"previous_names":["nfrastack/container-freescout"],"tags_count":380,"template":false,"template_full_name":null,"purl":"pkg:github/nfrastack/container-freescout","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nfrastack%2Fcontainer-freescout","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nfrastack%2Fcontainer-freescout/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nfrastack%2Fcontainer-freescout/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nfrastack%2Fcontainer-freescout/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nfrastack","download_url":"https://codeload.github.com/nfrastack/container-freescout/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nfrastack%2Fcontainer-freescout/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33389229,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T04:15:53.637Z","status":"ssl_error","status_checked_at":"2026-05-23T04:15:53.242Z","response_time":53,"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":["helpdesk","laravel","php-fpm"],"created_at":"2026-05-14T18:00:32.998Z","updated_at":"2026-05-23T09:03:32.505Z","avatar_url":"https://github.com/nfrastack.png","language":"Dockerfile","funding_links":["https://github.com/sponsors/tiredofit"],"categories":["Dockerfile"],"sub_categories":[],"readme":"# nfrastack/container-freescout\n\n## About\n\nThis repository will build a container image for running [FreeScout](https://freescout.net/) - an open source [Help Scout](https://www.helpscout.com/) / [Zendesk](https://www.zendesk.com/) alternative for shared inboxes, helpdesk, and ticketing.\n\n## Maintainer\n\n* [Nfrastack](https://www.nfrastack.com)\n\n## Table of Contents\n\n* [About](#about)\n* [Maintainer](#maintainer)\n* [Table of Contents](#table-of-contents)\n* [Installation](#installation)\n  * [Prebuilt Images](#prebuilt-images)\n  * [Quick Start](#quick-start)\n  * [Persistent Storage](#persistent-storage)\n* [Configuration](#configuration)\n  * [Environment Variables](#environment-variables)\n    * [Base Images used](#base-images-used)\n    * [Core Configuration](#core-configuration)\n    * [Database](#database)\n    * [Application](#application)\n    * [Setting FreesScout configuration](#setting-freescout-configuration)\n    * [Scheduler](#scheduler)\n  * [Networking](#networking)\n* [Maintenance](#maintenance)\n  * [Shell Access](#shell-access)\n* [Support \u0026 Maintenance](#support--maintenance)\n* [License](#license)\n* [References](#references)\n\n## Installation\n\n### Prebuilt Images\n\nBuilds are available on the [Github Container Registry](https://github.com/nfrastack/container-freescout/pkgs/container/container-freescout) and [Docker Hub](https://hub.docker.com/r/nfrastack/freescout):\n\n```text\nghcr.io/nfrastack/container-freescout:(image_tag)\ndocker.io/nfrastack/freescout:(image_tag)\n```\n\nImage tag syntax is:\n\n`\u003cimage\u003e:\u003coptional tag\u003e-\u003coptional phpversion\u003e`\n\nExample:\n\n`docker.io/nfrastack/freescout:latest` or `ghcr.io/nfrastack/container-freescout:2.0-php84`\n\n* `latest` will be the most recent commit on the latest PHP version\n* An optional `tag` may exist that matches the [CHANGELOG](CHANGELOG.md) - these are the safest\n\n\n| PHP version | Tag                      |\n| ----------- | ------------------------ |\n| 8.5.x       | `:\u003cimageversion\u003e-php8.5` |\n| 8.4.x       | `:\u003cimageversion\u003e-php8.4` |\n|             | `:latest`                |\n| 8.3.x       | `:\u003cimageversion\u003e-php8.3` |\n\nHave a look at the container registries and see what tags are available.\n\n#### Multi-Architecture Support\n\nImages are built for `amd64` by default, with optional support for `arm64` and other architectures.\n\n### Quick Start\n\n* The quickest way to get started is using [docker-compose](https://docs.docker.com/compose/). See [examples/compose.yml](examples/compose.yml) for a working stack you can tailor to your environment.\n* Map [persistent storage](#persistent-storage) for access to configuration and data files for backup.\n* Set [environment variables](#environment-variables) to control container behavior.\n\n**The first boot can take 2-5 minutes depending on your CPU as the schema is created and assets are warmed.**\n\n### Persistent Storage\n\nThe following directories should be mapped for persistent storage. The `/data` mount is recommended - it covers config, sessions, cache, modules, and the version marker in one place. Mounting `/www/html` instead is supported when you want the FreeScout source tree exposed for inspection or self-update.\n\n| Directory   | Description                                                            |\n| ----------- | ---------------------------------------------------------------------- |\n| `/logs`     | Nginx and PHP log files                                                |\n| `/www/html` | (Optional) Expose the FreeScout source tree to the host                |\n| **OR**      |                                                                        |\n| `/data`     | Persistent state - sessions, cache, uploads, `Modules/`, configuration |\n\n## Configuration\n\n### Environment Variables\n\nThis image relies on a customized base image in order to work.\nBe sure to view the following repositories to understand all the customizable options:\n\n#### Base Images used\n\n| Image                                                                 | Description         |\n| --------------------------------------------------------------------- | ------------------- |\n| [OS Base](https://github.com/nfrastack/container-base/)               | Base image          |\n| [Nginx](https://github.com/nfrastack/container-nginx/)                | Nginx webserver     |\n| [Nginx PHP-FPM](https://github.com/nfrastack/container-nginx-php-fpm) | PHP-FPM interpreter |\n| [Laravel](https://github.com/nfrastack/container-laravel)             | Laravel runtime     |\n\nBelow is the complete list of available options that can be used to customize your installation.\n\n* Variables showing an 'x' under the `Advanced` column can only be set if the containers advanced functionality is enabled.\n\n\n#### Core Configuration\n\n| Parameter                    | Description                                                                                                          | Default                | `_FILE` |\n| ---------------------------- | -------------------------------------------------------------------------------------------------------------------- | ---------------------- | ------- |\n| `SETUP_TYPE`                 | `AUTO` writes config, runs migrations, creates the bootstrap admin. `MANUAL` does nothing                            | `AUTO`                 |         |\n| `ADMIN_EMAIL`                | Email of the bootstrap admin user (created on a fresh DB only)                                                       | `admin@example.com`    | x       |\n| `ADMIN_FIRST_NAME`           | First name of the bootstrap admin                                                                                    | `Admin`                | x       |\n| `ADMIN_LAST_NAME`            | Last name of the bootstrap admin                                                                                     | `User`                 | x       |\n| `ADMIN_PASS`                 | Password of the bootstrap admin                                                                                      | `freescout`            | x       |\n| `ENABLE_AUTO_UPDATE`         | Auto-upgrade FreeScout source on container restart when image version differs from `${DATA_PATH}/.freescout-version` | `TRUE`                 |         |\n| `DATA_PATH`                  | Base persistent-data path (sessions, cache, modules, version marker live under here)                                 | `/data/`               |         |\n| `MODULES_PATH`               | Persistent storage for FreeScout `Modules/` directory                                                                | `${DATA_PATH}/Modules` |         |\n\n#### Database\n\n| Parameter | Description                                                  | Default | `_FILE` |\n| --------- | ------------------------------------------------------------ | ------- | ------- |\n| `DB_TYPE` | Database driver: `mysql`, `mariadb`, or `pgsql` / `postgres` | `mysql` |         |\n| `DB_HOST` | Hostname or container name of the database server            |         | x       |\n| `DB_PORT` | Database port                                                | `3306`  | x       |\n| `DB_NAME` | Database name (written to `.env` as `DB_DATABASE`)           |         | x       |\n| `DB_USER` | Database username (written to `.env` as `DB_USERNAME`)       |         | x       |\n| `DB_PASS` | Database password (written to `.env` as `DB_PASSWORD`)       |         | x       |\n| `DB_SSL`  | Enable SSL connectivity (`TRUE` / `FALSE`) for MySQL/MariaDB | `FALSE` |         |\n\n#### Application\n\n| Parameter  | Description                                                                     | Default | Alias      | `_FILE` |\n| ---------- | ------------------------------------------------------------------------------- | ------- | ---------- | ------- |\n| `APP_URL`  | Full external URL of the site (e.g. `https://freescout.example.com`). Required. |         | `SITE_URL` |         |\n| `SITE_URL` | Legacy alias for `APP_URL`                                                      |         |            |         |\n\n#### Setting FreeScout configuration\n\nFreeScout ships ~80 configuration keys (look inside the running container at `/www/html/.env.example` for a sample, or read the [upstream wiki](https://github.com/freescout-helpdesk/freescout/wiki/)).\n\nAny environment variable starting with `FREESCOUT_` is stripped of that prefix and written into the runtime config:\n\n```yaml\nenvironment:\n  - FREESCOUT_APP_PROXY=http://proxy.local:3128\n  - FREESCOUT_APP_TRUSTED_PROXIES=10.0.0.0/8\n  - FREESCOUT_APP_X_FRAME_OPTIONS=DENY\n  - FREESCOUT_APP_LOCALE=en\n  - FREESCOUT_APP_TIMEZONE=America/Vancouver\n  - FREESCOUT_MAIL_DRIVER=smtp\n  - FREESCOUT_MAIL_HOST=postfix-relay\n  - FREESCOUT_MAIL_PORT=25\n  - FREESCOUT_DB_PGSQL_SSL_MODE=require\n```\n\nbecomes the following lines in  (`/data/config/config` | `/www/html/.env`:\n\n```dotenv\nAPP_PROXY=http://proxy.local:3128\nAPP_TRUSTED_PROXIES=10.0.0.0/8\nAPP_X_FRAME_OPTIONS=DENY\nAPP_LOCALE=en\nAPP_TIMEZONE=America/Vancouver\nMAIL_DRIVER=smtp\nMAIL_HOST=postfix-relay\nMAIL_PORT=25\nDB_PGSQL_SSL_MODE=require\n```\n\n\u003e Three special values delete the matching `.env` line: `FREESCOUT_FOO=unset`, `FREESCOUT_FOO=null`, `FREESCOUT_FOO=`\n\u003e\n\u003e Docker secrets: any `FREESCOUT_\u003cKEY\u003e_FILE=/run/secrets/x` is resolved into `FREESCOUT_\u003cKEY\u003e=\u003ccontents\u003e` before passthrough.\n\n#### Scheduler\n\nFreeScout requires `php artisan schedule:run` to fire once per minute for mail fetching, queue dispatching, and report digests. This is an alternative to the in place cron service. Most people will not want this enabled. It is here for edge cases.\n\n| Parameter                    | Description                        | Default |\n| ---------------------------- | ---------------------------------- | ------- |\n| `ENABLE_FREESCOUT_SCHEDULER` | Toggle the in-container scheduler. | `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, `bash` and `sh` are available in the container. An `artisan` shell function is preinstalled and runs as the nginx user against `/www/html/artisan`.\n\n```bash\ndocker exec -it freescout-app bash\nartisan tinker\n```\n\n## Support \u0026 Maintenance\n\n* For community help, tips, and discussions, visit the [Discussions board](/discussions).\n* For personalized support or a support agreement, see [Nfrastack Support](https://nfrastack.com/).\n* To report bugs, submit a [Bug Report](issues/new). Usage questions will be closed as not-a-bug.\n* Feature requests are welcome but not guaranteed.\n* Updates are best-effort, with priority given to active production use and support agreements.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## References\n\n* \u003chttps://freescout.net/\u003e\n* \u003chttps://github.com/freescout-helpdesk/freescout/wiki\u003e\n* \u003chttps://github.com/freescout-helpdesk/freescout/wiki/Configuration\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnfrastack%2Fcontainer-freescout","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnfrastack%2Fcontainer-freescout","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnfrastack%2Fcontainer-freescout/lists"}