Skip to content
Support Portal

Self-hosted · GPL-3.0

A friendly support portal for FreeScout

Give your users a clean, form-based front door to FreeScout — submit tickets, attach files, and track status, without ever touching the agent UI.

Get started View on GitHub
  • + PHP 8.1+
  • + Docker-ready
  • + LDAP / local auth
#1043
Active
Technical problem
VPN won't connect from home
vpn-error.png 48 KB

Everything a user needs, nothing they don't

A focused front door to FreeScout — six pieces that do one job each.

forms

Dynamic request forms

Conditional fields per request type — onboarding, problems, changes, access and software requests.

conditional fields
auth

LDAP & local auth

Authenticate against Active Directory / LDAP, local SQLite accounts, or let users choose.

files

File attachments

Users attach screenshots and documents; uploads are type-, size- and content-validated.

status

Ticket dashboard

A "My Tickets" view with real-time status — Active, Pending, Closed — and full history.

Active Pending Closed
thread

Two-way messaging

Users reply to tickets and read responses from support staff in a single thread.

brand

Custom branding

Configure company name, logo, colors, icon, and support contacts to match your org.

See it in action

screenshot
portal.yourcompany.com
Support Portal showing the request-type selection screen with onboarding, technical problem and change request cards

How it works

3 steps
  1. 1

    User submits a request

    They pick a request type and fill in a dynamic form tailored to it.

  2. 2

    A ticket lands in FreeScout

    The portal calls the FreeScout API and opens the ticket in your mailbox.

  3. 3

    User tracks and replies

    They follow status updates and reply in a two-way thread from their dashboard.

Questions?

The short answers. The rest live on the full FAQ.

See all FAQs
What is Support Portal for FreeScout?

Support Portal is a free, self-hosted, open-source web app that gives your end users a friendly form-based interface to submit support tickets to FreeScout, attach files, and track ticket status — without giving them access to the FreeScout agent UI.

Is Support Portal free?

Yes. It is open-source software released under the GNU General Public License v3.0 and is free to self-host.

What do I need to run it?

PHP 8.1+ with the pdo_sqlite, curl, json, mbstring and fileinfo extensions, Composer, a web server (Apache or Nginx), and a FreeScout instance with the API module installed. The ldap extension is needed only for LDAP authentication.

Does it support LDAP / Active Directory?

Yes. It supports LDAP/Active Directory, local SQLite accounts, or both at once. LDAP binds over StartTLS or LDAPS and escapes credentials and the username filter.

Deploy

Self-host it in minutes

  • PHP 8.1+
  • A FreeScout instance with the API module
  • Docker (optional, but recommended)
Read the docs Star on GitHub
bash 
$ git clone https://github.com/jeffcaldwellca/support-portal.git
$ cd support-portal && cp .env.example .env
$ docker compose up -d
✔ portal running → http://localhost:8080