Troubleshooting

BetterPterodactyl Troubleshooting Guide

Issue: SSO Button Not AppearingCopy Anchor Link

If you're not seeing the "Login to Pterodactyl" button on your service page, follow these steps:

Check Extension Configuration

1. Go to Admin Panel → Extensions → Servers
2. Find the PterodactylSSO extension
3. Verify the following settings are configured:
   • Pterodactyl URL: Your panel URL (e.g., https://panel.example.com)
   • Pterodactyl API Key: Valid application API key
   • SSO Secret Key: The secret key from your Pterodactyl SSO setup

Test with New Service

Create a new test service using the PterodactylSSO extension to verify:

1. The server is created successfully
2. The user_id property is stored
3. The SSO button appears

Common Issues and SolutionsCopy Anchor Link

Issue: "SSO is not configured"Copy Anchor Link

Cause: SSO Secret Key is not set in extension settings
Solution: Add the SSO secret key to the extension configuration

Issue: "User ID not found"Copy Anchor Link

Cause: Service was created before SSO was configured
Solution:

1. Recreate the server, OR
2. Manually add the user_id property to the service

Issue: SSO Button Appears but Login FailsCopy Anchor Link

Causes and Solutions:

1. Invalid SSO Secret: Verify the secret matches Pterodactyl configuration
2. User doesn't exist in Pterodactyl: Check if user was created during server creation
3. SSO package not installed: Verify wemx/sso-pterodactyl is installed on Pterodactyl
4. Using Admin account: Accounts with admin permissions cant be used in SSO

---