How to recover access to your Strapi instance when credentials are lost

If you've lost access to your Strapi admin panel due to forgotten credentials or inaccessible accounts, there are several recovery methods available depending on your situation and hosting setup.

Password Recovery Methods

1. Email-based Password Reset (Recommended)

The simplest method is using the "Forgot Password" link on your admin login page:

1. Go to your Strapi admin panel login page

2. Click "Forgot Password"

3. Enter your email address

4. Check your email for reset instructions

Note: Even if you see an error message, check your email as the reset may still work correctly. The system shows the same response regardless of whether the email exists for security reasons.

2. CLI Command (Self-hosted instances)

If you have server access to your self-hosted Strapi instance, you can reset passwords using the command line:

Interactive mode:

strapi admin:reset-user-password

This will prompt you to enter the email and new password.

Direct mode:

strapi admin:reset-user-password -e user@example.com -p newpassword

This method requires SSH or direct machine access to your server.

Authentication Provider Issues

If you created your Strapi Cloud project using a specific authentication provider (GitHub, Google, etc.), you must continue using that same provider to access your project. Attempting to log in with a different method will create a new separate account and cause you to lose access to your original project.

To regain access, identify which authentication provider you originally used and log in exclusively through that provider.

Complete Lockout Scenarios

If you have no admin access, no email access, and no server access, support intervention may be required. This service is available to paid subscription holders (Enterprise, Growth, or Cloud plans).

Requirements for Support-Assisted Recovery

To request support assistance, you'll need to:

• Contact support from the email address associated with your subscription (billing email)

• Provide accurate project identification details:

  • Exact Cloud project URL (ensure complete accuracy - missing even one character can make your project appear non-existent)

  • Internal app ID

  • Subscription ID (found in invoice emails)

Support Recovery Process

When support creates new admin credentials:

• You'll receive temporary credentials via a one-time secret link

• The link expires in 7 days and can only be accessed once

• Save the credentials to a secure location immediately

• Change the password immediately after first login

• Remove any unwanted accounts from the Admin Dashboard

Understanding Admin Account Setup

When you first access your Strapi admin panel, you're prompted to create a super admin account. If you don't remember creating one, someone else likely already set up the initial admin account on your application.

Username Recovery

Strapi admin authentication is email-based. If you need to recover your username, check your profile settings in the admin panel or contact someone with database access to query the admin_users table.

Security Best Practices After Recovery

Once you regain access:

1. Immediately update your password to a secure one

2. Remove any unnecessary admin accounts from your dashboard

3. Document your credentials in a secure password manager

4. Consider setting up additional admin accounts for team members to prevent future lockouts