93 lines
2.4 KiB
Markdown
93 lines
2.4 KiB
Markdown
# 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
|
|
```bash
|
|
nut accounts
|
|
# or
|
|
nut account list
|
|
```
|
|
Outputs:
|
|
```text
|
|
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:
|
|
```bash
|
|
nut accounts --json
|
|
nut accounts --tsv
|
|
```
|
|
|
|
### Adding an Account
|
|
- **Interactive Browser Flow**:
|
|
```bash
|
|
nut login https://cloud.example.com --label "Work"
|
|
```
|
|
- **Interactive Terminal Password Prompt**:
|
|
```bash
|
|
nut login https://cloud.example.com --manual --label "Work"
|
|
```
|
|
- **Non-Interactive / Headless / Scripting**:
|
|
```bash
|
|
nut login https://cloud.example.com -u alice -p "app-password-token" --label "Work"
|
|
```
|
|
|
|
### Switching the Active Default Account
|
|
```bash
|
|
# 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:
|
|
```bash
|
|
nut upload --account "Work" report.pdf
|
|
nut upload --account "bob@nextcloud.org" archive.zip
|
|
```
|
|
|
|
### Removing an Account
|
|
```bash
|
|
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
|
|
|
|
1. Open the **Accounts & Auth** tab.
|
|
2. The list of connected accounts displays each account's server URL, username, label, and whether it is marked as default.
|
|
3. Click **Set as Default** on any account card to switch the primary default.
|
|
4. Click **Select as Active** to switch the current session's upload destination.
|
|
5. Click **Logout / Remove** to purge credentials from the OS keychain.
|