dosya CLIをインストールする

公式ダウンロードサービスからdosya CLIをインストールし、アカウントを接続する前にdosya --versionとdosya --helpを実行してください。リリースは単体の実行ファイルです。インストール済みのバイナリにはNode.js、npm、Bunは必要ありません。

対応プラットフォームと前提条件

コンピューター	リリースセレクター	インストール方法
Linux x86-64	linux	シェルインストーラーまたはダウンロードしたバイナリ
macOS Apple Silicon	mac-arm64	シェルインストーラーまたはダウンロードしたバイナリ
macOS Intel	mac-x64	シェルインストーラーまたはダウンロードしたバイナリ
Windows x64	windows	PowerShellでdosya.exeをダウンロード

インストーラーとアップデーターは、その他のOSとアーキテクチャの組み合わせを拒否します。このリリース設定ではLinux ARM64とWindows ARM64のビルドは提供されません。HTTPS接続とインストール先フォルダーへの書き込み権限が必要です。インストールやヘルプの閲覧にdosyaアカウントは不要です。ファイル操作にはAPIキーと該当するワークスペースの権限が必要です。

この図はインストールの流れをまとめたものです。以下のコマンドは現在のインストーラーとCLIリファレンスに基づいています。完了したインストールのターミナル記録ではありません。

手順：macOSまたはLinuxにインストールする

通常使っているターミナルで次を実行してください。

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

スクリプトはプラットフォームを検出し、対応するバイナリを/tmp/dosyaにダウンロードして実行可能にし、/usr/local/bin/dosyaに移動します。/usr/local/binに書き込めない場合は、sudoを使って移動します。macOSではダウンロードしたバイナリの隔離属性の削除も試みます。インストーラーの最後の出力には**dosya CLI installed successfully!**が含まれ、バージョンコマンドが実行されます。

実行前にスクリプトを確認したい場合は、まずファイルにダウンロードしてください。

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

最後のコマンドの前に内容を確認してください。インストールすると、/usr/local/bin/dosyaに保存された既存の実行ファイルは置き換えられます。ローカルで元に戻す必要がある場合は、信頼できる古いバイナリを別に保存してください。インストーラーはバックアップを保持せず、バージョン選択フラグも提供しません。

手動でダウンロードするにはhttps://api.dosya.dev/api/cli/latest?platform=linuxを使い、linuxを表のセレクターに置き換えてください。ダウンロードしたファイルの名前をdosyaに変更し、Unixでは実行可能にして、PATHに含まれるフォルダーに配置してください。インストールの参照先は公開されているCLIページであり、アプリ内の連携 → CLIコントロールではありません。

Windowsにインストールする

PowerShellでx64実行ファイルをダウンロードし、記載されたユーザーの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

curl.exeを使ってください。PowerShellのcurlエイリアスではなく、実行ファイルを呼び出します。このユーザーフォルダーを使えば管理者によるインストールは不要です。dosyaが見つからない場合は、このフォルダーがPATHに含まれていることを確認してください。Move-Itemが保存先の既存ファイルを報告する場合は、現在のバイナリを特定してコピーを保存してから、意図的に置き換えてください。不明な実行ファイルを確認せずに上書きしないでください。

実行されるファイルを確認する

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

バージョン出力はdosyaで始まり、インストール済みリリース番号が続きます。ヘルプにはサインインせずにコマンドとフラグが表示されます。macOS/Linuxではcommand -v dosyaでシェルが選択した実行ファイルを確認できます。PowerShellではGet-Command dosyaを使ってください。インストールが成功しても、PATHの先にある古いバイナリが優先される場合があります。

command not foundと表示された場合は、PATHの変更後に新しいターミナルを開き、インストール先フォルダーを確認してください。Unixでは/usr/local/bin/dosya --version、Windowsでは& "$env:LOCALAPPDATA\Microsoft\WindowsApps\dosya.exe" --versionで文書に記載された場所を直接テストできます。そこで動作する場合は、繰り返し再インストールせずPATHを修正してください。

アカウントとワークスペースを接続する

1. プロフィール → API（APIキー）を開き、API：APIキーを作成を選択して、CLI専用の名前を付け、実行するタスクに合う権限を選んでください。閲覧とアップロードにはフルアクセスを使います。このスコープは、ロールが許可する範囲で破壊的な操作も許可します。
2. プロトコルを個別に選択する場合は、制限と有効期限でREST APIを許可してください。フォルダーは未設定のままにしてください。通常のフォルダーに固定されたキーはCLIのRESTリクエストに使えず、This API key is anchored at a folder and can only be used over WebDAV or the S3 gatewayと表示されて拒否されます。ワークスペース、有効期限、利用制限を確認し、キーを生成を選択してください。完全なdos_キーが表示されている間に保存してください。一覧のプレフィックスでは認証できません。
3. dosya auth loginを実行し、**Enter API key:**にキーを貼り付けてください。対話式プロンプトではキーは表示されません。認証に成功すると、Authenticated asとアカウント名、メールアドレスが表示されます。
4. dosya workspace listを実行し、返された実際のワークスペースIDを使ってdosya workspace use ws_exampleを実行してください。後続のコマンドの標準設定になります。明示的な--workspaceはこれより優先されます。

CLIは名前付きサインインプロフィールではなく、1つのローカル設定を保存します。標準では~/.dosya/config.jsonです。XDG_CONFIG_HOMEを設定すると、そのフォルダーのdosyaサブフォルダーに保存されます。サインイン時も既存の標準ワークスペースは保持されます。ファイルにはキーが含まれ、Unixではオーナーのみの権限で書き込まれます。自動処理では、非公開で渡したDOSYA_API_KEY環境変数を使うか、シークレットをdosya auth login --key -にパイプしてください。コマンド引数やシェル履歴にキーを直接記載しないでください。DOSYA_API_BASEは保存済みのAPIアドレスより優先されます。通常の値はhttps://api.dosya.devです。

更新、ロールバック、アンインストール

インストール済みのバイナリからdosya upgradeを実行してください。最新のマニフェストを確認し、公開されたSHA-256を検証してから、現在の場所の実行ファイルを置き換えます。Already on latest versionは置き換えが不要だったことを示します。更新時にチェックサムが欠落または不正な場合はインストールを拒否し、バイトが異なる場合はChecksum mismatch - refusing to installを報告します。その場所への書き込み権限が必要になる場合があります。マニフェストのリクエストは30秒、バイナリのダウンロードは5分でタイムアウトします。

信頼されていないAPIホストが設定されている場合、明示的に許可しない限り拒否されます。通常の更新前に公式API設定を復元してください。--forceは、設定されたサーバーが報告する再インストールやダウングレードを許可しますが、過去のバージョンを選択するものではありません。ロールバック用に信頼できるバイナリを別に保存してください。実行ファイルを置き換えてもローカル設定は移行も削除もされません。最新のダウンロードはリリース後最大1時間キャッシュされる場合があるため、更新後に実際のバージョンを確認してください。

dosya uninstallは確認を求め、インストール済みの実行ファイルと、保存済みサインイン情報および標準ワークスペースを含むCLI設定フォルダー全体を削除します。元に戻すコマンドはありません。クラウドファイルの削除やサーバー側のAPIキーの無効化は行いません。そのコンピューターからのアクセスを失効させる場合は、プロフィールでキーを無効化してください。ソースのチェックアウトからアンインストールを実行した場合は設定のみが削除され、dosya upgradeはソースからの実行を拒否します。

Unsupported platformは、検出されたシステムに対応するリリースがないことを示します。セレクターに対するNo CLI build found forは、そのリリースファイルが利用できないことを示します。後で公式ダウンロードを再試行してください。**Authentication failed: invalid API key.**の場合は、CLIを再ダウンロードせず、完全なキー、有効期限、無効化の状態を確認してください。

確認できる結果

シェルが公式の実行ファイルを選択し、バージョンとヘルプを表示して、目的のアカウントで認証できます。インストールだけではワークスペースにファイルは作成されません。保存された標準ワークスペースは選択後にのみ適用されます。

関連ガイド

• CLIでフォルダーをアップロード
• APIキーの管理