Troubleshooting & FAQ

When something isn't right.

Installation troubleshooting Fixes for the most common SummitPSA install failures: prerequisites, license-gated image pulls, the database wait, and reaching the setup wizard.
Email isn't sending or receiving Diagnose outbound SMTP and inbound email-to-ticket problems, including IMAP polling, Mailgun webhooks, and why some messages are intentionally skipped.
Can't log in or access problems Resolve login failures: invalid credentials, account lockouts, forced password changes, two-factor prompts, idle timeouts, and CSRF errors.
Performance and slowness Practical steps to diagnose a sluggish SummitPSA install: web workers, the database, email polling, container resources, and where to look in the logs.
General FAQ Answers to the most common questions about what SummitPSA is, how it's deployed, where data lives, and how to operate the stack.
Licensing and billing FAQ How SummitPSA licensing works: the phone-home check, the grace window, seat counting, and what happens to your install if the license lapses.
Self-hosting and data FAQ Where your SummitPSA data lives, how to back it up, how secrets are stored, and how to upgrade or move your self-hosted install.