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

# Troubleshooting

> Solutions to common issues on Daki Hosting: suspended servers, startup failures, upload problems, networking, and more.

This page covers the most common problems users run into on Daki Hosting and how to solve them. If your issue is not listed here, check the [FAQ](../faq) or reach out through the appropriate [support channel](./support).

***

## Server Status Issues

<AccordionGroup>
  <Accordion title="My server is suspended — how do I reactivate it?">
    **Free Tier:** Your <Tooltip tip="The time budget a Free Tier server runs for; extend it by watching ads.">runtime</Tooltip> counter reached zero. Log in to the <Tooltip tip="The free-hosting site (dash.daki.cc) where you manage your free server.">Free Tier Dashboard</Tooltip> at [dash.daki.cc](https://dash.daki.cc) and watch ads to add runtime. You have a **2-day grace period** after <Tooltip tip="The server is offline but its files are preserved, pending renewal.">suspension</Tooltip> before the server is permanently deleted. See [Renewing Your Free Server](./save-free-server-from-purge).

    **Paid plan:** Your billing period ended without a successful renewal. Log in to the <Tooltip tip="Daki's billing site (billing.daki.cc) for plans, invoices, credits, and payments.">Billing Panel</Tooltip> at [billing.daki.cc](https://billing.daki.cc), add credits or a payment method, and renew your service. You have a **7-day window** before the service is permanently cancelled and data deleted. See [Billing & Payments](./billing).
  </Accordion>

  <Accordion title="My server was deleted — can I recover my files?">
    No. Once a Free Tier server is deleted after the 2-day grace period, or a paid service is cancelled after the 7-day suspension window, all data is permanently removed and cannot be recovered. Always keep an external backup of your code (e.g., on GitHub).
  </Accordion>

  <Accordion title="My server is stuck on 'Installing' or 'Starting'">
    Wait 1–2 minutes and refresh the <Tooltip tip="Daki's Pterodactyl-based server-management panel (portal.daki.cc).">Portal</Tooltip>. If the status does not change, try clicking **Kill** in the Console tab and then **Start** again. If the problem persists, ask for help on [Discord](https://discord.gg/daki).
  </Accordion>
</AccordionGroup>

***

## Startup & Runtime Issues

<AccordionGroup>
  <Accordion title="My server crashes immediately after starting">
    Open the **Console** tab in the Portal and read the error output. Common causes:

    * **Wrong startup command** — filename typo or wrong path. Compare the filename in the Startup tab to what appears in the Files tab.
    * **Missing entry point file** — your code may not have been uploaded yet, or is in a subdirectory. See [File Manager](./file-manager).
    * **Dependencies not installed** — check that the install command is set correctly (e.g., `npm install` or `pip install -r requirements.txt`) in the Startup tab and restart. See [Startup Settings](./startup-settings).
    * **Wrong Docker image** — your code requires a newer runtime version. Check the image in the Startup tab.
  </Accordion>

  <Accordion title="My startup command doesn't work">
    Verify in the **Startup** tab:

    1. The startup command points to the correct filename (case-sensitive).
    2. The selected <Tooltip tip="The specific runtime version your server's container runs (e.g. Node.js 22).">Docker image</Tooltip> matches your application's language version.
    3. You restarted the server after making changes.

    See [Startup Settings](./startup-settings).
  </Accordion>

  <Accordion title="I selected the wrong Docker image">
    Go to the **Startup** tab, pick the correct image from the dropdown, and restart. Changing the Docker image does not delete your files.
  </Accordion>

  <Accordion title="Out-of-memory crash (OOM kill)">
    Your application is using more RAM than your plan allows. The Console will typically show the process being killed without an error message, or a line like `Killed` or `exit code 137`.

    * **Free Tier:** The limit is 512 MB. Optimise your application's memory usage or upgrade to a paid plan.
    * **Paid plan:** Optimise memory usage or upgrade to a higher-tier plan with more RAM. See [App & Bot Hosting Plans](./paid-plans).
  </Accordion>

  <Accordion title="My dependencies are not being installed">
    Make sure the **install command** is set correctly in the **Startup** tab:

    * Node.js: `npm install`
    * Python: `pip install -r requirements.txt`

    Restart the server after setting the install command to trigger it.
  </Accordion>
</AccordionGroup>

***

## File Upload Issues

<AccordionGroup>
  <Accordion title="I can't upload a folder in the file manager">
    Direct folder upload is not supported in the web file manager. Use one of these workarounds:

    1. Compress your folder into a `.zip` or `.tar.gz`, upload the archive, then right-click and select **Extract**.
    2. Use <Tooltip tip="Secure File Transfer Protocol — upload/download files with no size limits.">SFTP</Tooltip> to upload the folder directly with no restrictions.

    See [File Manager](./file-manager).
  </Accordion>

  <Accordion title="File upload fails or times out">
    The web file manager has a per-file upload size limit. For large files, use SFTP. Your SFTP credentials are in the **Settings** tab. See [File Manager](./file-manager).
  </Accordion>

  <Accordion title="I can't connect via SFTP">
    Check the following:

    * **Host and port** — verify in the **Settings** tab of your server in the Portal.
    * **Username** — use your Portal username exactly as shown.
    * **Password** — use your Portal account password (not your Discord password or Billing Panel password).
    * **Server state** — SFTP requires your server to be in a non-suspended state.

    See [File Manager](./file-manager).
  </Accordion>
</AccordionGroup>

***

## Networking Issues

<AccordionGroup>
  <Accordion title="My web application / API is not accessible from outside">
    **Free Tier:** Free Tier servers do not have publicly accessible ports. External inbound connections are not supported on the Free Tier. You need a paid plan to expose a web server or API publicly. See [Network & Allocations](./network-allocations).

    **Paid plan:** Verify that your application is listening on the port shown in the **Network** tab of the Portal. Applications listening on any other port will not be reachable from outside.
  </Accordion>

  <Accordion title="My Discord bot works fine but my HTTP server doesn't">
    Discord bots connect outbound to Discord and do not need an open port — they work on both Free Tier and paid plans. HTTP servers need an inbound port, which requires a paid plan. See [Network & Allocations](./network-allocations).
  </Accordion>
</AccordionGroup>

***

## Login & Account Issues

<AccordionGroup>
  <Accordion title="I can't log in to the Free Tier Dashboard">
    The Free Tier Dashboard uses Discord OAuth. Make sure you are logged into Discord in your browser (or have the Discord desktop app open). Try clearing your browser cache or using a different browser.

    If you recently changed your Discord email address, contact support on Discord — your account may need to be re-linked manually.
  </Accordion>

  <Accordion title="I forgot my Billing Panel password">
    Use the **"Forgot Password"** link on the Billing Panel login page at [billing.daki.cc](https://billing.daki.cc). A password reset link will be sent to your registered email address.
  </Accordion>

  <Accordion title="I forgot my Portal password">
    **Free Tier:** Your Portal password is shown in the **Credentials** tab at [dash.daki.cc/credentials](https://dash.daki.cc/credentials).

    **Paid plan:** Go to the **Password** tab on your active service page in the Billing Panel and generate a new Portal password.
  </Accordion>

  <Accordion title="I'm confused about which panel to use">
    There are three separate interfaces:

    * **Free Tier Dashboard** ([dash.daki.cc](https://dash.daki.cc)) — Free Tier account management, login with Discord.
    * **Billing Panel** ([billing.daki.cc](https://billing.daki.cc)) — purchasing plans and billing, own login with email/password.
    * **Portal** ([portal.daki.cc](https://portal.daki.cc)) — managing your actual servers, log in via <Tooltip tip="Single sign-on — one-click Portal login with no separate password.">SSO</Tooltip> from the other two panels.

    See [Portal Overview](./portal) for a full comparison.
  </Accordion>
</AccordionGroup>

***

## Common Suspension Reasons

| Reason                                           | What happens                                       |
| :----------------------------------------------- | :------------------------------------------------- |
| Free Tier runtime counter reached zero           | Server suspended; deleted after 2-day grace period |
| Paid plan billing period expired without renewal | Server suspended; deleted after 7-day grace period |
| Multiple accounts created by one person          | All accounts may be suspended                      |
| Terms of Service violation / abuse               | Account may be permanently suspended               |

To avoid unintentional issues: watch ads regularly (Free Tier), keep sufficient credits (paid), and follow the [Terms of Service](https://daki.cc/legal/terms-of-service).

***

## Still Stuck?

* **Check the status page first:** [status.daki.cc](https://status.daki.cc) — your issue may be due to an ongoing incident.
* **Free Tier users:** Open a ticket through the [Discord server](https://discord.gg/daki).
* **Paid users:** Open a ticket in the [Billing Panel](https://billing.daki.cc) or on [Discord](https://discord.gg/daki).

See [Getting Help](./support) for full details on support channels.