Free Customer Support Helpdesk with Knowledge Base

Every growing business hits the same wall: customer emails pile up, important questions get lost, and you have no idea if anyone actually replied. The obvious fix is a helpdesk tool like Zendesk or Help Scout — until you see the price tag. Zendesk charges $19–$115 per agent per month. Help Scout charges $25–$75 per user per month. A 5-person support team pays $1,500–$5,750 every single year just to manage email conversations.

FreeScout is an open-source help desk and shared mailbox — a free, self-hosted Zendesk & Help Scout alternative (GitHub) | Official Website. It handles email ticketing, shared inboxes, knowledge base, live chat, and multi-channel support (WhatsApp, Telegram, Facebook, Slack) — all for free, on your own server, with unlimited agents.

The Problem This Solves

If you're running a small business, you probably handle customer support through a shared Gmail inbox or a generic email address like support@yourcompany.com. It works — until it doesn't:

• No accountability: You can't tell who replied to which email or whether it was answered at all
• No collision detection: Two agents reply to the same customer simultaneously
• No knowledge base: Customers ask the same questions repeatedly because there's nowhere to find answers
• No reporting: You have no idea about response times, resolution rates, or agent workload
• No automation: Routing, auto-replies, and SLA tracking are all manual

The SaaS solutions solve all of this — but at $25–$115 per agent per month, they're prohibitively expensive for small teams. FreeScout gives you the same core functionality for the cost of a $5/month VPS.

What You Need

• A VPS with at least 1GB RAM (2GB recommended for production) — we recommend a basic Linux VPS from Hostinger, Hetzner, or DigitalOcean ($5–$8/month)
• Docker and Docker Compose installed on your server
• 30–45 minutes of your time
• No coding skills required — the entire setup is copy-paste commands
• A domain name pointing to your server (e.g., support.yourcompany.com)
• An email address for your support mailbox (e.g., support@yourcompany.com) with IMAP/SMTP access

Step-by-Step Setup with Docker

Step 1: Prepare Your Server

SSH into your VPS and make sure Docker and Docker Compose are installed:

sudo apt update && sudo apt upgrade -y
sudo apt install -y docker.io docker-compose
sudo systemctl enable docker
sudo systemctl start docker

Step 2: Create the FreeScout Directory

mkdir -p /opt/freescout
cd /opt/freescout

Step 3: Create the Docker Compose File

Create a docker-compose.yml file with the following content. This sets up FreeScout with a MariaDB database and automatic database backups:

cat > docker-compose.yml << 'EOF'
services:
  freescout-app:
    image: docker.io/nfrastack/freescout:latest
    container_name: freescout-app
    volumes:
      - ./data:/data
      - ./logs:/logs
    environment:
      - DB_TYPE=mariadb
      - DB_HOST=freescout-db
      - DB_PORT=3306
      - DB_NAME=freescout
      - DB_USER=freescout
      - DB_PASS=ChangeThisStrongPassword123!

      # Admin credentials (only used on first setup)
      - ADMIN_EMAIL=admin@yourcompany.com
      - ADMIN_FIRST_NAME=Admin
      - ADMIN_LAST_NAME=User
      - ADMIN_PASS=ChangeThisAdminPassword456!

      # Your support URL
      - APP_URL=https://support.yourcompany.com

      # Mail settings (configure with your SMTP provider)
      - FREESCOUT_MAIL_DRIVER=smtp
      - FREESCOUT_MAIL_HOST=smtp.yourprovider.com
      - FREESCOUT_MAIL_PORT=587
      - FREESCOUT_MAIL_FROM_ADDRESS=support@yourcompany.com
      - FREESCOUT_MAIL_FROM_NAME=Your Company Support
      - FREESCOUT_MAIL_ENCRYPTION=tls

      - FREESCOUT_APP_LOCALE=en
    ports:
      - "8080:80"
    depends_on:
      - freescout-db
    restart: always

  freescout-db:
    image: docker.io/mariadb:11
    container_name: freescout-db
    volumes:
      - ./db:/var/lib/mysql
    environment:
      - MARIADB_ROOT_PASSWORD=ChangeThisRootPassword789!
      - MARIADB_DATABASE=freescout
      - MARIADB_USER=freescout
      - MARIADB_PASSWORD=ChangeThisStrongPassword123!
    restart: always

networks:
  default:
    driver: bridge
EOF

Important: Replace all passwords and the APP_URL with your actual values before proceeding. Use strong, unique passwords.

Step 4: Start the Containers

docker compose up -d

The first boot takes 2–5 minutes as the database schema is created and assets are warmed up. Check the logs to monitor progress:

docker compose logs -f freescout-app

Once you see the application is ready, press Ctrl+C to exit the log viewer.

Step 5: Set Up SSL with a Reverse Proxy

For production, you need HTTPS (browser push notifications require it, and your customers deserve a secure connection). The easiest approach is using Nginx Proxy Manager or Caddy as a reverse proxy:

Option A — Nginx Proxy Manager (recommended if you already use it):

# Add the FreeScout container to your NPM network
docker network connect nginx_proxy_manager_default freescout-app

# In NPM admin panel, create a proxy host:
# Domain: support.yourcompany.com
# Forward to: freescout-app:80
# Enable SSL with Let's Encrypt

Option B — Caddy (simplest automatic SSL):

# Run Caddy alongside FreeScout
docker run -d --name caddy --network freescout_default   -p 80:80 -p 443:443   -v /opt/caddy/Caddyfile:/etc/caddy/Caddyfile   caddy:latest

# Caddyfile content:
# support.yourcompany.com {
#   reverse_proxy freescout-app:80
# }

Step 6: Complete the Web Setup

Open your browser and navigate to https://support.yourcompany.com (or http://YOUR_SERVER_IP:8080 if you haven't set up SSL yet). The FreeScout web installer will guide you through the final steps:

1. Enter your database credentials (pre-filled from environment variables in Docker setup)
2. Create your admin account
3. Configure your first mailbox — enter your support email's IMAP and SMTP settings
4. Set up cron jobs for email fetching (the Docker image handles this automatically)

Step 7: Configure Email Fetching

FreeScout needs to regularly fetch emails from your support mailbox. If using the Docker image, the scheduler runs automatically. For manual installations, add this to your crontab:

* * * * * php /var/www/html/artisan schedule:run >> /dev/null 2>&1

Configure your mailbox in Settings → Mailboxes with these common IMAP settings:

• Gmail: imap.gmail.com:993 (SSL), smtp.gmail.com:587 (TLS) — use an App Password
• Outlook/Office 365: outlook.office365.com:993 (SSL), smtp.office365.com:587 (TLS)
• Zoho Mail: imap.zoho.com:993 (SSL), smtp.zoho.com:587 (TLS)

Step 8: Enable the Knowledge Base Module

FreeScout includes a built-in knowledge base module. To enable it:

1. Go to Manage → Modules in the admin panel
2. Find Knowledge Base and click Activate
3. Navigate to Manage → Knowledge Base to create categories and articles
4. Your knowledge base will be available at https://support.yourcompany.com/kb

What This Gives You

• Shared inbox — All customer emails flow into one shared mailbox that your entire team can see and manage
• Collision detection — See when another agent is viewing or replying to the same conversation
• Knowledge base — Publish self-service articles so customers find answers without emailing you
• Multi-channel support — Connect email, WhatsApp, Telegram, Facebook, Slack, and live chat into one inbox (via modules)
• Unlimited agents — Add as many team members as you want. No per-seat pricing, ever
• Auto-replies & saved replies — Set automatic responses for common questions and reusable reply templates
• Ticket tagging & folders — Organize conversations with tags, custom folders, and saved searches
• SLA & workflows — Automatically route, prioritize, and escalate conversations based on rules
• Real-time reports — Track response times, resolution rates, and agent performance
• Mobile apps — iOS and Android apps for managing support on the go
• Email & push notifications — Get alerted about new tickets, mentions, and assignments
• Customer portal — Let customers view their conversation history and submit new tickets
• API & integrations — REST API, Zapier, and Make (Integromat) integrations for connecting with your other tools
• 30+ languages — Full multilingual support including English, Spanish, French, German, Arabic, Chinese, and more

Cost Comparison: FreeScout vs Zendesk vs Help Scout

The math: A 5-agent team on Zendesk Suite Team pays $95/month ($1,140/year). On Help Scout Standard, that's $125/month ($1,500/year). With FreeScout, you pay $5–8/month for the VPS — that's it. Over 3 years, you save $3,300–$6,600. And if your team grows to 10 agents, the SaaS costs double while FreeScout stays the same.

Too Complex? We Can Set This Up for You

If you'd rather not deal with Docker, SSL certificates, and email configuration, we handle the entire setup process for you. You get a fully configured helpdesk on your own domain, ready to receive customer tickets.

One-Time Setup — $299

• FreeScout installed on your VPS with Docker
• SSL certificate configured (HTTPS)
• Email mailbox connected (IMAP/SMTP)
• Knowledge base module enabled and configured
• Up to 3 mailboxes set up (e.g., support@, billing@, sales@)
• Admin and first agent accounts created
• Basic workflow rules configured
• 1 hour of training on how to use the system

Monthly Managed — $149/month

• Everything in the one-time setup
• Server monitoring and uptime guarantees
• Automatic FreeScout updates and security patches
• Database backups (daily, 30-day retention)
• Email deliverability monitoring
• Module installation and configuration
• Priority support (response within 4 business hours)
• Up to 2 hours of changes/customization per month

6-Month Bundle — $1,499 (Save $199)

• One-time setup + 6 months of managed hosting
• Best value for businesses that want a hands-off experience
• Includes migration from Zendesk or Help Scout
• Custom workflow automation setup
• Renewable at $149/month after 6 months

Get in touch to get started →

Frequently Asked Questions

Is FreeScout really free?

Yes. FreeScout is licensed under the AGPL-3.0 license and is completely free to use. The only cost is your VPS hosting ($5–$8/month), which you'd need for any self-hosted application. There are no per-agent fees, no feature tiers, and no hidden costs. Optional paid modules exist for advanced features, but the core helpdesk is fully functional for free.

How is FreeScout different from Zendesk or Help Scout?

Functionally, FreeScout provides the same core features: shared inbox, ticket management, collision detection, auto-replies, knowledge base, and reporting. The key differences are: (1) FreeScout is self-hosted, so you own your data, (2) there are no per-agent fees — add unlimited agents for free, and (3) you control when updates happen. The trade-off is that you're responsible for server maintenance, which is why we offer managed hosting.

Can I migrate from Zendesk or Help Scout to FreeScout?

Yes. FreeScout has a built-in migration tool that imports tickets, customers, and conversation history from other helpdesk platforms. The tool supports importing from Zendesk, Help Scout, and other systems via CSV or API. The FreeScout documentation provides step-by-step migration guides, and our managed setup service includes migration assistance.

Does FreeScout support live chat on my website?

Yes. FreeScout has a Live Chat module that adds a chat widget to your website. Visitors can chat with your support team in real time, and conversations are saved as tickets in your FreeScout inbox. The module is free and can be activated from the Modules section in your admin panel.

Can I connect WhatsApp, Facebook, or Telegram to FreeScout?

Yes. FreeScout supports multi-channel communication through modules. There are official modules for WhatsApp, Facebook Messenger, Telegram, and Slack. Each module connects the respective channel to your FreeScout inbox, so all customer conversations — regardless of channel — appear in one place.

How many agents can I add?

Unlimited. Unlike Zendesk and Help Scout, which charge per agent, FreeScout has no agent limit. You can add 1 or 1,000 agents at no additional cost. The only limiting factor is your server's resources — a 2GB VPS comfortably handles 10–20 agents.

Is my customer data secure with FreeScout?

FreeScout is self-hosted, meaning all customer data stays on your server. You're not relying on a third-party SaaS company's security practices. FreeScout is designed with security in mind: it supports HTTPS, has role-based access control, and the team actively patches vulnerabilities. You control backups, encryption, and access. For sensitive industries (healthcare, finance), self-hosting often satisfies compliance requirements that cloud SaaS tools cannot.

What happens if FreeScout stops being developed?

FreeScout is open-source (AGPL-3.0), so even if the original developers stop maintaining it, the community can fork and continue development. The code is on GitHub with 4,500+ stars and an active community. Your installation continues to work regardless of the project's status — you're not dependent on a company staying in business, unlike with SaaS tools.

Do I need to know how to code to use FreeScout?

No. The web installer handles setup through a browser-based wizard. Day-to-day usage — answering tickets, managing agents, creating knowledge base articles, setting up workflows — is all done through the admin interface. You only need command-line access for the initial Docker setup, and that's just copy-pasting the commands above. If that's still too technical, our one-time setup service handles everything for you.