---
title: "SSH and SFTP users"
url: https://docs.corefinity.com/guides/sites/access-and-security/ssh-and-sftp-users
type: guide
last_updated: 2026-11-13
feature: ssh-users
---
# SSH and SFTP users

Give a colleague or a client their own sign-in to a site, for a shell across the whole site or for file transfer in one folder.

## Before you start

- You can open the site in **Managed Websites**. Anyone who can open a site can add, change and remove its users.
- A site can have up to 25 users.
- A user connects with the host and port on [Connection details](/guides/sites/access-and-security/connection-details), from an IP address on the [firewall](/guides/sites/access-and-security/firewall).

## Add a user

1. **Open Users & keys**

   Go to **Managed Websites**, choose the site, then **Users & keys** under **Access & security**. On the **Users** card, choose **Add user**.

   _Screenshot: The Users card with Add user ringed. It lists the users designer, an SFTP only user limited to one folder, and hartley-dev, an SSH user with the whole site, each with its keys, password and the status Active._

2. **Name the user and choose a type**

   Enter a **Username** of 3 to 31 lower-case letters, digits and hyphens, starting with a letter. Add a **Label** saying who it is for, then choose the **Type**.

   | Type          | What the user gets                                       |
   | ------------- | -------------------------------------------------------- |
   | **SSH**       | A shell and SFTP across the whole site.                  |
   | **SFTP only** | File transfer only, limited to one **Folder**. No shell. |

   _Screenshot: The Add user dialog with the username photographer, the label Product photos, the type SFTP only, a list of folders to choose from, and the Password choices None, Generate one and Set one now\._

3. **Choose how the user signs in**

   Under **Password**, choose **None** to use keys only, **Generate one** or **Set one now**. A generated password is shown once after the user is added; a password you set has 12 to 64 characters and cannot be shown again.

4. **Add the user**

   Choose **Add user**. The user shows **Applying**, then **Active**.

## Add a key, change or remove a user

1. **Open the user's menu**

   Open the user's **…** menu.

   _Screenshot: The Users card with the menu open on the user designer: Add key…, Show commands, Edit…, Rotate password…, Remove password… and Remove user…._

2. **Choose the action**

   | Action                                                        | What it does                                                                                                                                                      |
   | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | **Add key…**                                                  | Adds a public key of an [accepted type](/guides/sites/access-and-security/ssh-keys#accepted-key-types) that signs in as this user. A user can hold up to 50 keys. |
   | **Show commands**                                             | Shows the SSH and SFTP commands for this user.                                                                                                                    |
   | **Edit…**                                                     | Changes the label, the type or the folder. The username cannot be changed.                                                                                        |
   | **Set password…**, **Rotate password…**, **Remove password…** | Sets, replaces or removes the password.                                                                                                                           |
   | **Remove user…**                                              | Ends the user's access. Files they created stay on the site.                                                                                                      |

> **Note:** The built-in user `web` cannot be changed or removed: deployments and shared keys use it.

## Automate this

**API:** [Create an SSH or SFTP user](https://docs.corefinity.com/api/reference/access/create-site-access-user.md), scope `write`

```bash
curl -X POST https://manage.corefinity.com/api/corestack/sites/1042/access/users \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Photographer",
    "password": "generate",
    "root_path": "htdocs/wp-content/uploads",
    "type": "sftp",
    "username": "photographer"
  }'
```

**MCP:** [`corestack_ssh_user_create`](https://docs.corefinity.com/mcp/tools/corestack_ssh_user_create.md), scope `write`

```json
{
  "name": "corestack_ssh_user_create",
  "arguments": {
    "site_id": 4211,
    "username": "deploy",
    "type": "ssh"
  }
}
```

**Control Panel:** Managed Websites › your site › Access & security › Connection details ([https://manage.corefinity.com/go/access](https://manage.corefinity.com/go/access))

## Related

- [SSH keys](/guides/sites/access-and-security/ssh-keys): Add a key to log in over SSH.
- [Connection details](/guides/sites/access-and-security/connection-details): Find the host, port and commands.
- [Firewall](/guides/sites/access-and-security/firewall): Allow an IP address to reach a site.
