Multi-Account Management Guide

Nextcloud Upload Tool supports managing multiple Nextcloud instances and user accounts simultaneously. Credentials, account metadata, and active default states are shared seamlessly between the CLI and GUI frontends.

1. How Accounts Are Identified

Every configured account has a canonical ID in the format:

username@host

(e.g. alice@cloud.example.com or dev@nextcloud.local)

You can also assign an optional friendly label (e.g. "Work", "Personal", "Backup").

2. Managing Accounts via CLI (`nut`)

Listing Configured Accounts

nut accounts
# or
nut account list

Outputs:

Configured Nextcloud Accounts:

  • alice@cloud.example.com * (active default)
    Username: alice
    Server:   https://cloud.example.com
    Label:    Work

  • bob@nextcloud.org 
    Username: bob
    Server:   https://nextcloud.org
    Label:    Personal

To output as JSON or TSV for scripting:

nut accounts --json
nut accounts --tsv

Adding an Account

Interactive Browser Flow:

nut login https://cloud.example.com --label "Work"

Interactive Terminal Password Prompt:

nut login https://cloud.example.com --manual --label "Work"

Non-Interactive / Headless / Scripting:

nut login https://cloud.example.com -u alice -p "app-password-token" --label "Work"

Switching the Active Default Account

# Set default by label
nut account default Work

# Or set default by full account ID
nut account default alice@cloud.example.com

Uploading to a Specific Account

Use the --account / -a flag on any upload command to override the active default for that invocation:

nut upload --account "Work" report.pdf
nut upload --account "bob@nextcloud.org" archive.zip

Removing an Account

nut account delete "Work"

This removes the account from ~/.config/nut/accounts.json and deletes the associated app token from your OS keychain.

3. Managing Accounts in the GUI

Open the Accounts & Auth tab.
The list of connected accounts displays each account's server URL, username, label, and whether it is marked as default.
Click Set as Default on any account card to switch the primary default.
Click Select as Active to switch the current session's upload destination.
Click Logout / Remove to purge credentials from the OS keychain.

2.4 KiB Raw Permalink Blame History