# Troubleshooting

This section helps you fix common issues you may encounter after installing Investra, without needing advanced technical knowledge.

## 1. Website Shows Blank Page or Error

What this means:

The application is installed, but some basic setup is missing.

What to do:

- Make sure you completed all installation steps
- Confirm that the `.env` file exists on your server
- Ask your hosting provider to check file permissions for:
- `storage`
- `bootstrap/cache`

If you are using shared hosting (cPanel), this is very common and easily fixed by support.

## 2. Database Connection Error

What this means:

Investra cannot connect to your database.

What to check:

- Database name
- Database username
- Database password

What to do:

- Open your `.env` file
- Make sure the database details match exactly with your hosting database settings
- Ensure the database has already been created

If unsure, contact your hosting provider and ask them to verify database access.

## 3. Admin Changes Not Showing

Example issues:

- Investment settings not updating
- Payment settings not reflecting
- Content appears outdated

What to do:

- Refresh your browser (Ctrl + F5)
- Clear your browser cache
- Go to your Admin Panel
- Navigate to Extra → Info
- Click on Clear Cache
- Restart the server (if applicable)

## 4. Images or Uploaded Files Not Showing

What this means:

The server is not properly linked to uploaded files.

What to do:

- Ensure the `public/storage` folder exists
- If using shared hosting, ask support to create a storage symlink
- From Admin, run `YOUR_WebsiteLink/admin/storage-link` in your browser to create the symlink

> ⚠️ Important:

> Some hosting providers do not allow symlinks. You may need to contact them directly to set up the symlink.

This is a very common setup step, and hosting support can do it for you.

## 5. Payment Gateway Not Working

Common reasons:

- Incorrect payment credentials
- Using live credentials in test mode (or vice versa)
- Callback or webhook URL not set

What to do:

- Double-check payment keys in Admin Panel
- Ensure payment mode matches your credentials
- Confirm callback/webhook URLs are added correctly

Test payments only after saving all settings.

## 6. Emails Not Sending

What this means:

Email service is not configured or is blocked by hosting.

What to do:

- Check email settings in Admin Panel
- Use SMTP instead of the default mail driver
- Ask hosting support if outgoing mail is blocked

This depends on hosting configuration, not Investra itself.

## 7. reCAPTCHA Not Working or Not Updating

Example issues:

- reCAPTCHA enabled in admin but not showing
- reCAPTCHA keys changed but old keys are still being used
- Form submits without reCAPTCHA validation

What to do:

- Make sure the reCAPTCHA Site Key and Secret Key are correct
- Confirm the domain is added in Google reCAPTCHA settings
- Clear your browser cache (Ctrl + F5)
- Go to your Admin Panel
- Navigate to Extra → Info
- Click on Clear Cache
- Restart or redeploy the application (if applicable)

## 8. Social Login Not Working (Google / Facebook, etc.)

Example issues:

- Social login enabled but buttons do not appear
- Login redirects but fails
- Settings saved but changes do not reflect

What to do:

- Verify Client ID and Client Secret are correct
- Ensure the callback/redirect URL is added exactly as required
- Confirm the social app is set to Live (not test mode)
- Clear your browser cache (Ctrl + F5)
- Go to your Admin Panel
- Navigate to Extra → Info
- Click on Clear Cache
- Redeploy (if applicable)

Social login changes usually require a restart to apply.

## 9. Permission or Access Errors (403 / 404)

What this means:

Server permissions or routing is not set correctly.

What to do:

- Make sure the `.htaccess` file exists (for Apache servers)
- Ask hosting support to reset folder permissions
- Confirm your domain is pointing to the correct public folder

## 10. Still Having Issues?

If the problem continues:

- Take screenshots of the error
- Copy the exact error message
- Contact support with clear details
- Visit https://support.softivus.com/

Providing accurate information helps resolve issues faster.

✅ Most installation problems are server configuration issues, not software bugs.

Investra works correctly when installed according to the documentation.