> ## Documentation Index
> Fetch the complete documentation index at: https://docs.breezehost.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Common Issues and Troubleshooting

> Quick solutions for common Breeze Hosting problems

Experiencing issues with your Breeze Hosting service? Here are solutions for common problems. If you don't find your issue here, check the [FAQ](/troubleshooting/faq) or [contact support](/troubleshooting/faq#how-do-i-get-support).

## Server Won't Start

Your server should start automatically, but sometimes it needs a manual restart.

### Quick Fixes

<Steps>
  <Step title="Check Service Status">
    Log in to [dash.breezehost.xyz](https://dash.breezehost.xyz) and go to your service
  </Step>

  <Step title="Look for Status Indicator">
    Check if your service shows as "Active" or if there's an error message
  </Step>

  <Step title="Restart Server">
    Click the "Restart" button in your service controls
  </Step>

  <Step title="Wait for Restart">
    Give it 30-60 seconds to restart and come online
  </Step>

  <Step title="Check Status Again">
    Refresh the page to see if your service is running
  </Step>
</Steps>

### Still Not Starting?

<Accordion title="Check Service Payment">
  Your service may be suspended if payment is overdue.

  * Go to Invoices in your billing panel
  * Look for any unpaid invoices
  * Pay outstanding balances immediately
  * Your service should restart within minutes
</Accordion>

<Accordion title="Check Resource Limits">
  If your service exceeds resource limits, it may stop automatically.

  * Go to your service dashboard
  * Check CPU, RAM, and disk usage
  * If at maximum capacity, upgrade your plan or optimize your code
  * Restart after addressing the issue
</Accordion>

<Accordion title="Check System Status">
  There may be a temporary server issue.

  * Visit [uptime.breezehost.xyz](https://uptime.breezehost.xyz)
  * Check for any active incidents
  * If there's a known issue, our team is working on it
  * Wait for the status page to show "All Systems Operational"
</Accordion>

<Accordion title="Contact Support">
  If your server still won't start:

  1. Open a ticket in our [Discord server](https://discord.gg/breezehost)
  2. Or email [support@breezehost.xyz](mailto:support@breezehost.xyz)
  3. Include your service name and error messages
  4. Our team will investigate within 24 hours
</Accordion>

## High Resource Usage

Your service may be running slowly or consuming too many resources.

### Diagnosing High Usage

<Steps>
  <Step title="Check Dashboard">
    Log in to your service and go to the dashboard or console
  </Step>

  <Step title="Review Metrics">
    Look for CPU, RAM, and disk usage percentages
  </Step>

  <Step title="Identify Spike">
    Note if usage is always high or if it spikes at certain times
  </Step>
</Steps>

### Common Causes and Solutions

<Accordion title="Memory Leak">
  Your application may have a memory leak causing gradual resource increase.

  **Solution:**

  1. Review your code for memory leaks (especially in loops or event listeners)
  2. Optimize variables and clean up objects after use
  3. Restart your service to free up memory temporarily
  4. Monitor memory usage after restart

  **Note:** We can help with hosting issues, but not with code debugging. See our [FAQ](/troubleshooting/faq#do-you-help-with-coding).
</Accordion>

<Accordion title="Too Many Background Processes">
  You may have multiple services or bots running on the same server.

  **Solution:**

  1. Check what processes are running
  2. Identify unnecessary services and stop them
  3. Consider running services on separate plans if both are needed
  4. Optimize your startup scripts to only run essential processes
</Accordion>

<Accordion title="Inefficient Database Queries">
  Database queries or operations may be consuming excessive resources.

  **Solution:**

  1. Review database query logs if available
  2. Optimize queries to reduce load
  3. Consider upgrading to a higher plan with more resources
  4. Use database indexing and caching strategies
</Accordion>

<Accordion title="Bot Activity">
  If you're hosting a Discord bot, it may generate high resource usage during peak hours.

  **Solution:**

  1. Optimize your bot's event listeners and message handlers
  2. Reduce polling frequency if checking status periodically
  3. Use Discord sharding if handling multiple guilds
  4. Consider upgrading to a higher plan
</Accordion>

### Upgrade Your Plan

If your service consistently hits resource limits:

1. Go to your service in the billing panel
2. Click "Upgrade" and choose a higher tier
3. Your resources will increase immediately
4. You'll only pay the prorated difference for the current month

<Info>
  See [Plan Limits](/plans-and-limits) for detailed specifications of each plan.
</Info>

## File Upload Failures

Problems uploading files to your server?

### Check File Size

<Steps>
  <Step title="Verify File Size">
    Check your file's size on your computer (right-click > Properties)
  </Step>

  <Step title="Compare to Limit">
    Each Breeze plan has a maximum file size limit (typically 512MB per file)
  </Step>

  <Step title="Split Large Files">
    If your file exceeds the limit, split it into smaller parts
  </Step>

  <Step title="Retry Upload">
    Try uploading the file again
  </Step>
</Steps>

### Check File Permissions

<Steps>
  <Step title="Open File Manager">
    In your service panel, click "File Manager" or "Files"
  </Step>

  <Step title="Navigate to Folder">
    Go to the folder where you want to upload the file
  </Step>

  <Step title="Check Permissions">
    Look for a "Permissions" button or right-click the folder
  </Step>

  <Step title="Ensure Write Access">
    Make sure the folder has write permissions enabled
  </Step>

  <Step title="Update if Needed">
    Change permissions to allow uploads (usually 755 or 777)
  </Step>
</Steps>

### Check Network Connection

<Steps>
  <Step title="Test Internet Connection">
    Open a new tab and visit a website to confirm internet is working
  </Step>

  <Step title="Try Again">
    Refresh the file manager and attempt the upload again
  </Step>

  <Step title="Use Smaller File">
    Try uploading a smaller file to test if the issue is size-related
  </Step>

  <Step title="Try Different Method">
    If web upload fails, try FTP/SFTP access if available
  </Step>
</Steps>

### Other Solutions

<Accordion title="Clear Browser Cache">
  Cached files may interfere with uploads.

  1. Clear your browser's cache and cookies
  2. Close and reopen your browser
  3. Log back into the billing panel
  4. Try uploading again
</Accordion>

<Accordion title="Try Different Browser">
  Browser issues may prevent uploads.

  1. Try uploading from a different browser
  2. Try on a different device
  3. This helps identify if it's a browser or account issue
</Accordion>

<Accordion title="Check Storage Space">
  You may be out of disk space.

  1. Go to your service dashboard
  2. Check "Disk Usage" or "Storage"
  3. If full, delete unnecessary files
  4. Or upgrade to a plan with more storage
</Accordion>

## Connection Timeouts

Your application can't connect to external services or databases.

### Connection Timeout Causes

Connection timeouts usually mean:

* Network connectivity issue
* Firewall blocking the connection
* The external service is down or unreachable
* Incorrect connection settings (wrong host, port, or credentials)

### Troubleshooting Steps

<Steps>
  <Step title="Check Internet Connection">
    Ensure your server has internet access by visiting your service
  </Step>

  <Step title="Verify Target is Online">
    Check if the service you're connecting to is online and accessible
  </Step>

  <Step title="Check Firewall Rules">
    If connecting to a database, check that the firewall allows your IP
  </Step>

  <Step title="Verify Connection Details">
    Double-check hostname, port, username, and password
  </Step>

  <Step title="Test Connection">
    If possible, test the connection from your computer
  </Step>
</Steps>

### Database Connection Timeouts

If you're experiencing MongoDB or other database connection issues, see [MongoDB Connection Issues](/troubleshooting/mongodb-connection).

### Still Timing Out?

<Steps>
  <Step title="Get Diagnostic Info">
    Note the exact error message and timestamp
  </Step>

  <Step title="Contact Support">
    Email [support@breezehost.xyz](mailto:support@breezehost.xyz) or open a Discord ticket
  </Step>

  <Step title="Provide Details">
    Include:

    * Service name
    * Error message and stack trace
    * What you're trying to connect to
    * When the issue started
  </Step>
</Steps>

## Panel Access Issues

Can't log in or access your billing panel?

### Can't Log In

<Steps>
  <Step title="Check Email">
    Make sure you're using the correct email address for your account
  </Step>

  <Step title="Check Password">
    Verify you're typing your password correctly (case-sensitive)
  </Step>

  <Step title="Try Reset Password">
    Click "Forgot Password?" and follow the email link to reset it
  </Step>

  <Step title="Check Email">
    Look in spam or promotions folder for the reset email
  </Step>

  <Step title="Clear Cache">
    Clear your browser cache and cookies, then try again
  </Step>
</Steps>

### 2FA Issues

If you have two-factor authentication enabled:

<Steps>
  <Step title="Check Authenticator App">
    Make sure your code is current (codes change every 30 seconds)
  </Step>

  <Step title="Try Backup Code">
    If your authenticator app isn't working, use a backup code instead
  </Step>

  <Step title="Check Time Sync">
    Ensure your device's time is correct (authenticator codes depend on time)
  </Step>

  <Step title="Lost All Codes">
    Contact support to reset 2FA on your account
  </Step>
</Steps>

### Page Won't Load

<Steps>
  <Step title="Check Internet">
    Verify you have internet connection
  </Step>

  <Step title="Try Different Browser">
    Try a different browser to rule out browser issues
  </Step>

  <Step title="Clear Cache">
    Clear your browser's cache and cookies
  </Step>

  <Step title="Check Status Page">
    Visit [uptime.breezehost.xyz](https://uptime.breezehost.xyz) to see if billing panel is down
  </Step>

  <Step title="Wait and Retry">
    If the status shows an incident, wait a few minutes and try again
  </Step>
</Steps>

## Out of Memory Errors

Your service is running out of available memory.

### Understanding OOM Errors

"Out of memory" errors mean your application is trying to use more RAM than your plan provides.

### Quick Fixes

<Steps>
  <Step title="Restart Service">
    Restart your service to clear memory and restart fresh
  </Step>

  <Step title="Check Usage">
    After restart, monitor memory usage in your dashboard
  </Step>

  <Step title="Identify Spike">
    Watch for when memory usage increases suddenly
  </Step>
</Steps>

### Long-Term Solutions

<Accordion title="Optimize Memory Usage">
  Review your code for memory leaks and inefficiencies.

  * Check for variables that aren't properly cleaned up
  * Reduce cache sizes if applicable
  * Close unused connections
  * Optimize data structures

  Note: We provide hosting support, not code debugging. See [FAQ](/troubleshooting/faq#do-you-help-with-coding).
</Accordion>

<Accordion title="Reduce Load">
  If your application legitimately needs that much memory:

  1. Run fewer services on the same plan
  2. Disable unnecessary features
  3. Reduce user/data load if possible
</Accordion>

<Accordion title="Upgrade Your Plan">
  If optimization isn't possible, upgrade to a higher tier.

  1. Go to your service in the billing panel
  2. Click "Upgrade"
  3. Choose a plan with more RAM
  4. Your service will immediately have more memory available
</Accordion>

## Still Need Help?

If your issue isn't listed here or our solutions didn't work:

<CardGroup cols={2}>
  <Card title="Check the FAQ" icon="circle-question" href="/troubleshooting/faq">
    Browse frequently asked questions
  </Card>

  <Card title="Contact Discord Support" icon="discord">
    Open a ticket in our Discord server
  </Card>

  <Card title="Email Support" icon="envelope">
    Email [support@breezehost.xyz](mailto:support@breezehost.xyz)
  </Card>

  <Card title="Check Status Page" icon="circle-info">
    Visit [uptime.breezehost.xyz](https://uptime.breezehost.xyz)
  </Card>
</CardGroup>

When contacting support, please include:

* Your service name
* When the issue started
* Exact error messages
* Steps you've already tried
* Any relevant logs or screenshots