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

# FTP Accounts

> Create and manage FTP accounts to transfer files to your web hosting

FTP accounts let you transfer files to your hosting without sharing your main cPanel password. Each account can be restricted to a single directory, which is what makes them useful for giving a developer or an agency access to one site and nothing else.

<Info>
  **Prerequisites**

  * A Web Hosting service with OnetSolutions
  * Access to your cPanel account
  * An FTP client such as FileZilla, WinSCP, or Cyberduck
</Info>

## Creating an FTP Account

<Steps>
  <Step title="Log in to cPanel">
    Access your cPanel account through the OnetSolutions dashboard.
  </Step>

  <Step title="Open FTP Accounts">
    In the "Files" section, click "FTP Accounts".
  </Step>

  <Step title="Enter the account details">
    Fill in the "Log In" field with the username you want. cPanel appends your domain automatically, so the full username becomes `user@yourdomain.com` — this complete form is what you enter in your FTP client, not just the short name.
  </Step>

  <Step title="Set the directory">
    The "Directory" field controls what the account can reach. cPanel pre-fills it based on the username; replace it with the directory you actually want to grant, for example `public_html/staging`.
  </Step>

  <Step title="Set a quota and create">
    Leave the quota "Unlimited" or set a size in MB, then click "Create FTP Account".
  </Step>
</Steps>

<Warning>
  The directory you set is a boundary, not a suggestion — but only if you set it deliberately. Leaving it at the account root gives access to every site on the hosting account, which defeats the purpose of a separate account.
</Warning>

## Connecting

Use these settings in your FTP client:

| Setting    | Value                                  |
| ---------- | -------------------------------------- |
| Host       | `yourdomain.com`                       |
| Username   | `user@yourdomain.com`                  |
| Port       | 21 (FTP) or 22 (SFTP, where available) |
| Encryption | Explicit FTP over TLS                  |

<Warning>
  Always choose an encrypted connection. Plain FTP sends your username and password across the network in clear text, where anyone on the path can read them. In FileZilla this is "Require explicit FTP over TLS".
</Warning>

## Special Accounts

cPanel shows accounts you did not create, listed under "Special FTP Accounts". These map to the hosting account itself and cannot be deleted. Use a dedicated account for day-to-day transfers rather than the main one.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Authentication fails with the right password">
    The most common cause is an incomplete username. FTP accounts require the full `user@yourdomain.com` form, including the domain. Entering just `user` fails even when the password is correct.
  </Accordion>

  <Accordion title="Connection times out">
    Some networks block outbound port 21. Try switching your client from active to passive mode, which is the default in most clients and works through more firewalls.
  </Accordion>

  <Accordion title="Files upload but the site does not change">
    Check where you actually landed. Files must be inside `public_html` for the main domain, or the document root of the subdomain or addon domain concerned. Uploading one level above is a frequent mistake.
  </Accordion>

  <Accordion title="Permission denied when writing">
    The account's directory restriction is doing its job. Confirm the target path is inside the directory set when the account was created.
  </Accordion>
</AccordionGroup>

<Tip>
  Delete FTP accounts you no longer use. An account created for a contractor two years ago is a credential still valid today — removing it takes a click and closes a door you forgot was open.
</Tip>