Deploy FreeScout
Free self-hosted help desk and shared inbox, with MariaDB and volumes
MariaDB
Just deployed
/var/lib/mysql
FreeScout
Just deployed
/data
Deploy and Host FreeScout on Railway
FreeScout is a free, open-source help desk and shared inbox built with PHP (Laravel), a self-hosted alternative to Help Scout and Zendesk. Your team answers customer email together in shared mailboxes, with assignments, notes, saved replies, collision detection, customer profiles and modules, from the browser or the mobile app.
About Hosting FreeScout
FreeScout needs a PHP web server, a MySQL or MariaDB database, a background queue worker and a scheduler that runs every minute to fetch mail. This template runs FreeScout 1.8.251 (image nfrastack/freescout:2.2.25, pinned by digest) built from a public GitHub repo, plus MariaDB 11.8.9. On the first start it writes the config, creates the tables and the first administrator, with a generated password. The config, APP_KEY, attachments and modules stay on a volume, and the database on its own volume, so redeploys keep everything. You only enter the admin email. Afterwards, connect your support mailbox over IMAP and SMTP in the app.
Common Use Cases
- Shared support inbox (support@, info@) answered by a team
- Lightweight self-hosted ticketing in place of Help Scout or Zendesk
- Customer communication history with notes, tags and assignments kept on your own infrastructure
Dependencies for FreeScout Hosting
- MariaDB 11.8 (bundled, private network only)
- An email account with IMAP and SMTP access for each support mailbox (added after deploy)
Deployment Dependencies
- FreeScout: https://freescout.net and https://github.com/freescout-help-desk/freescout (release 1.8.251)
- Docker image: https://github.com/nfrastack/container-freescout (tag 2.2.25)
- Template repo: https://github.com/aalfath/freescout-railway-template
- MariaDB: https://hub.docker.com/_/mariadb
Implementation Details
After deploy:
- Open the FreeScout service's domain and sign in with the
ADMIN_EMAILyou entered and the generatedADMIN_PASS(FreeScout service, Variables tab). Change the password in your profile. - Go to Manage → Mailboxes, add a mailbox and enter its IMAP (incoming) and SMTP (outgoing) settings. FreeScout fetches new mail every minute.
- Invite your team under Manage → Users.
For a custom domain, add it to the FreeScout service and set APP_URL to https://YOUR-DOMAIN. Any other FreeScout .env setting can be added as a variable with the FREESCOUT_ prefix (for example FREESCOUT_APP_LOCALE=de), and TIMEZONE sets the time zone.
Updates: version bumps are merged into the template repo, and Railway offers them to you as an "update available" notice. A newer version runs FreeScout's database migrations by itself on start. Read the repo's CHANGELOG.md first and back up both volumes.
Why Deploy FreeScout on Railway?
Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.
By deploying FreeScout on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.
Template Content
MariaDB
mariadb:11.8.9FreeScout
aalfath/freescout-railway-templateADMIN_EMAIL
Email (login) of the first FreeScout administrator, created on the first start.
