Installare la CLI dosya

Installa la CLI dosya dal servizio di download ufficiale, poi esegui dosya --version e dosya --help prima di collegare l’account. La CLI è un eseguibile autonomo: il binario installato non richiede Node.js, npm o Bun.

Piattaforme supportate e requisiti

Computer	Selettore versione	Installazione
Linux x86-64	linux	Script di installazione o binario scaricato
macOS Apple Silicon	mac-arm64	Script di installazione o binario scaricato
macOS Intel	mac-x64	Script di installazione o binario scaricato
Windows x64	windows	Scarica dosya.exe con PowerShell

Il programma di installazione e quello di aggiornamento rifiutano altre combinazioni di sistema operativo e architettura; questa configurazione di rilascio non fornisce build Linux ARM64 o Windows ARM64. Servono una connessione HTTPS e il permesso di scrivere nella directory di installazione. Per installare la CLI e consultare la guida non serve un account dosya; per le operazioni sui file servono una chiave API e i permessi pertinenti nello spazio di lavoro.

L’illustrazione riassume la sequenza di installazione. I comandi seguenti provengono dall’installer e dal riferimento CLI attuali; l’immagine non è una registrazione nel terminale di un’installazione completata.

Procedura: installa su macOS o Linux

Esegui nel terminale che usi abitualmente:

curl -fsSL https://api.dosya.dev/api/cli/install | sh

Lo script rileva la piattaforma, scarica il binario corrispondente in /tmp/dosya, lo rende eseguibile e lo sposta in /usr/local/bin/dosya. Se /usr/local/bin non è scrivibile, chiede a sudo di eseguire lo spostamento. Su macOS tenta anche di rimuovere l’attributo di quarantena dal binario scaricato. L’output finale include dosya CLI installed successfully! ed esegue il comando della versione.

Se preferisci esaminare lo script prima di eseguirlo, scaricalo in un file:

curl -fsSL https://api.dosya.dev/api/cli/install -o dosya-install.sh
less dosya-install.sh
sh dosya-install.sh

Esaminalo prima dell’ultimo comando. L’installazione sostituisce qualsiasi eseguibile già presente in /usr/local/bin/dosya; conserva separatamente un vecchio binario attendibile se ti serve tornare indietro. L’installer non conserva copie di sicurezza né offre un’opzione per scegliere la versione.

Per un download manuale usa https://api.dosya.dev/api/cli/latest?platform=linux, sostituendo linux con il selettore nella tabella. Rinomina il file scaricato in dosya, rendilo eseguibile su Unix e inseriscilo in una directory già presente nel PATH. La pagina CLI pubblica è il riferimento per l’installazione, invece di un comando Integrazioni → CLI nell’app.

Installa su Windows

In PowerShell, scarica l’eseguibile x64 e spostalo nella cartella utente indicata nel PATH:

curl.exe -fsSL -o dosya.exe "https://api.dosya.dev/api/cli/latest?platform=windows"
Move-Item dosya.exe "$env:LOCALAPPDATA\Microsoft\WindowsApps\"
dosya --version
dosya --help

Usa curl.exe, che richiama l’eseguibile invece dell’alias curl di PowerShell. Questa directory utente evita un’installazione come amministratore. Se dosya non viene trovato, verifica che la directory sia nel PATH. Se Move-Item segnala una destinazione esistente, identifica il binario corrente e conservane una copia prima di sostituirlo deliberatamente; non sovrascrivere un eseguibile sconosciuto senza verificarlo.

Verifica quale eseguibile viene avviato

dosya --version
dosya --help
dosya upload --help

L’output della versione inizia con dosya, seguito dal numero della versione installata. La guida elenca comandi e opzioni senza richiedere l’accesso. Su macOS/Linux, command -v dosya mostra l’eseguibile scelto dalla shell; in PowerShell usa Get-Command dosya. Un vecchio binario che appare prima nel PATH può prevalere anche dopo un’installazione riuscita.

Se compare command not found, apri un nuovo terminale dopo una modifica al PATH e controlla la directory di installazione. Su Unix, /usr/local/bin/dosya --version, oppure su Windows, & "$env:LOCALAPPDATA\Microsoft\WindowsApps\dosya.exe" --version, verifica direttamente il percorso indicato. Se lì funziona, correggi il PATH invece di reinstallare ripetutamente.

Collega account e spazio di lavoro

1. Apri Profilo → Chiavi API, scegli Crea una chiave API, assegna un nome specifico per la CLI e scegli i permessi per le attività previste. Per esplorare e caricare, usa Accesso completo; questo ambito consente anche operazioni distruttive dove il ruolo lo permette.
2. In Restrizioni e scadenza, consenti API REST se scegli singoli protocolli. Lascia Cartella non impostato: una normale chiave vincolata a una cartella non può usare le richieste REST della CLI ed è rifiutata con This API key is anchored at a folder and can only be used over WebDAV or the S3 gateway. Controlla spazio di lavoro, scadenza e restrizioni d’uso, poi scegli Genera la chiave. Conserva la chiave completa dos_ mentre è visibile; il prefisso nella riga non permette l’autenticazione.
3. Esegui dosya auth login e incolla la chiave a Enter API key:. La richiesta interattiva nasconde la chiave. Se l’autenticazione riesce, viene mostrato Authenticated as con nome ed email dell’account.
4. Esegui dosya workspace list, poi dosya workspace use ws_example usando un ID spazio di lavoro effettivamente restituito. Questo imposta il valore predefinito per i comandi successivi; --workspace esplicito prevale.

La CLI conserva una sola configurazione locale, non profili di accesso con nomi diversi. Per impostazione predefinita si trova in ~/.dosya/config.json; se imposti XDG_CONFIG_HOME, si trova nella sottodirectory dosya di quella directory. L’accesso conserva uno spazio di lavoro predefinito esistente. Il file contiene la chiave ed è scritto con permessi riservati al proprietario su Unix. Per l’automazione usa la variabile d’ambiente DOSYA_API_KEY fornita privatamente o passa un segreto a dosya auth login --key -; evita una chiave letterale negli argomenti o nella cronologia della shell. DOSYA_API_BASE prevale sull’indirizzo API salvato, normalmente https://api.dosya.dev.

Aggiornamento, ritorno alla versione precedente e rimozione

Esegui dosya upgrade da un binario installato. Il comando controlla il manifest più recente, verifica lo SHA-256 pubblicato e sostituisce l’eseguibile nella posizione corrente. Already on latest version indica che non serve sostituirlo. L’aggiornamento rifiuta un checksum assente o malformato e segnala Checksum mismatch - refusing to install se i byte differiscono. Può richiedere il permesso di scrittura nella posizione. Il timeout della richiesta del manifest è di 30 secondi; quello del download del binario è di 5 minuti.

Un host API configurato non attendibile viene rifiutato salvo autorizzazione esplicita; ripristina l’API ufficiale prima di un aggiornamento normale. --force consente la reinstallazione o una versione precedente indicata dal server configurato, ma non seleziona una versione storica. Conserva separatamente un binario attendibile per tornare indietro; sostituire l’eseguibile non migra né rimuove la configurazione locale. I download più recenti possono restare nella cache fino a 1 ora dopo il rilascio: verifica la versione effettiva dopo l’aggiornamento.

dosya uninstall chiede conferma e rimuove l’eseguibile installato e l’intera directory di configurazione CLI, inclusi accesso salvato e spazio di lavoro predefinito. Non esiste un comando per annullare. Non elimina i file cloud né revoca la chiave API sul server; revoca la chiave nel Profilo se il computer deve perdere l’accesso. Eseguita da una copia del codice sorgente, la disinstallazione rimuove solo la configurazione; dosya upgrade rifiuta l’esecuzione dal sorgente.

Unsupported platform indica che non esiste una versione per il sistema rilevato. No CLI build found for seguito da un selettore indica che il file di quella versione non è disponibile; riprova più tardi il download ufficiale. Se compare Authentication failed: invalid API key., controlla la chiave completa, la scadenza e l’eventuale revoca, senza scaricare di nuovo la CLI.

Risultato previsto

La shell sceglie l’eseguibile ufficiale, che mostra versione e guida e si autentica con l’account desiderato. La sola installazione non crea file nello spazio di lavoro; quello predefinito salvato si applica solo dopo averlo scelto.

Guide correlate

• Caricare una directory con la CLI
• Gestione delle chiavi API