Open Source|All improvements go through Pull Requests with automated CI checks before review by@Leo-Galli|Join Discord|Contributing guide
SFTP users

SFTP user management

Create and manage SFTP access for server file management.

Create an SFTP user

Admin → SFTP → Add User, or via the API:

curl -sS http://127.0.0.1:8000/api/system/sftp \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "server_id": 1,
    "username": "webuser",
    "home_path": "/home/container",
    "enabled": true
  }'

Rules

  • Username must start with a lowercase letter.
  • Allowed characters: lowercase letters, digits, underscores.
  • The pair (server_id, username) must be unique.
  • Home path defaults to /home/container.

List users

curl -sS http://127.0.0.1:8000/api/system/sftp \
  -H "Authorization: Bearer $TOKEN"

Update / delete

# Update
curl -sS http://127.0.0.1:8000/api/system/sftp/{id} \
  -X PATCH \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"enabled":false}'
 
# Delete
curl -sS http://127.0.0.1:8000/api/system/sftp/{id} \
  -X DELETE \
  -H "Authorization: Bearer $TOKEN"

See also: Backend, Security.