Skip to main content
Hercules handles user authentication for you using Hercules Auth. Allow your users to sign in with email, Gmail, Microsoft, or SAML/SSO.
Customizable login page

​
How do I enable auth for my app?

Just ask Hercules to set it up for you.
Add authentication to app
Add login to my app

​
How does Hercules Auth work?

When your users click the login/sign up button, they are redirected to a customizable login portal. Your user chooses a login option. After authenticating, they are redirected back to your app and the authentication is officially saved on your app’s frontend and backend.

​
What login methods are supported?

Hercules Auth currently supports the following sign-up and login options:
  • Google
  • Microsoft
  • Email via one-time passcode
  • SAML / SSO (for Business customers only)

​
How do I customize the login page?

Go to Branding > Customize Login. See Branding & SEO.
Login and OTP email customization

​
Do I have to use Hercules Auth? Can I use my own custom auth?

Currently, Hercules apps only supports Hercules Auth. Authentication is a fragile part of building software. If auth breaks, your entire app can break. We prioritize making Hercules Auth a stable, well-supported, secure, and robust auth system. We are working on allowing you to customize auth more (see FAQ below)

​
Where can I view all the users who signed up for my app?

Go to the Users tab in the sidebar. You can also see more in the Users table of the Database tab
Users list

​
How can I implement roles, permission, and other access controls?

Just ask Hercules to set it up for you.
Set up roles and permissions
Assign different roles to my users and let me customize the permissions for each.

​
Additional FAQ

We’re actively improving authentication with these features planned for the near future:
  • More auth options — SMS OTP, email/password, and additional OAuth providers
  • Customize displayed options — Choose which login methods to show your users
  • In-app auth flows — Handle authentication inside your app instead of a separate login page
  • Managed role-based access control — Simplified role and permission management with pre-built UI
  • User impersonation — Allow admins to impersonate users for support and debugging
  1. Ask Hercules to configure auth like in the Hercules Auth debugging guide
  2. Accept any changes it recommends
  3. If still not working, please click “Report an issue” and someone from the Hercules team will help.
OTP emails can be blocked by corporate or secure mail servers (common with Outlook and other business email environments), or by email antivirus software at the company level. Here’s what to try:
  1. Check your spam/junk folder — the email may have been filtered.
  2. Try a different login method or email — Google or Microsoft sign-in will bypass OTP delivery entirely. if your corporate email is on a secured server, a Gmail or personal address will work immediately.
  3. Ask your IT team to whitelist our sending domains:
    • hercules.app
    • notifications.hercules.app This is the most common fix for users on corporate or secured email environments. Once whitelisted, OTPs should come through reliably.
  4. Email antivirus blocking — if your company uses email antivirus software, it may be intercepting OTP emails. If you know the name of your provider, share it when you contact us so we can investigate.
If the issue persists, reach out at hello@hercules.app.
Ask Hercules to implement role-based access controls with admin and superadmin roles Do not try to impersonate a user. Instead, for B2B apps, give the admin role the permission to access to any organization instead of impersonating individual users.
User impersonation is not currently available. You cannot build this yourself. We are building this feature soon. In the meantime, use role-based access controls and give admin users permissions to access “orgs” or “projects” rather than impersonate a specific user.
Currently, no. Hercules apps only support Hercules Auth. Authentication is a fragile part of building software. If auth breaks, your entire app can break. We prioritize making Hercules Auth a stable, well-supported, secure, and robust auth system. We only support Hercules auth at this time.
Currently, all enabled auth methods are shown to users. The ability to selectively show or hide specific login options is coming soon.
Not currently. Hercules Auth works by redirecting to a Hercules-hosted authentication page. We are working on improving this to allow in-app authentication flows in the near future.