Common Issues & Troubleshooting

500 Internal Server Error after Upload

• Check that storage/ and bootstrap/cache/ have write permissions (755).
• Make sure .env file exists — the installer creates it automatically.
• Check storage/logs/laravel.log for the actual error message.

Installer Redirects to 404

• Make sure mod_rewrite is enabled on Apache.
• Confirm the .htaccess file was uploaded (it's hidden — enable "show hidden files" in your FTP client).
• On Nginx, ensure try_files $uri $uri/ /index.php?$query_string; is in your config.

Vendor Folder Missing Error

• The vendor/ folder is included in the ZIP inside Script/.
• Some hosting file managers fail to extract all 5,000+ vendor files. Use FTP instead.
• FileZilla is recommended — it shows progress and confirms all files transferred.

AI Not Responding

• Verify your API key is correct in Admin → Settings → AI Providers.
• Check that the provider is toggled on.
• Confirm your API account has available credits/quota with the provider.

Emails Not Sending

• Go to Admin → Settings → Email and click Send Test Email.
• Double-check SMTP host, port, and encryption settings.
• Gmail users: use an App Password, not your regular password.

Still need help?

Open a support ticket at kodecraft.io/portal with your error message and we'll get back to you.