CLI リファレンス
lolipop はロリポップ！デプロイナウのコマンドラインツールです。
インストール
npm install -g lolipop実行には Node.js 22.12.0 以上が必要です。
コマンド一覧
| コマンド | 用途 |
|---|---|
lolipop login | ログインしてセッションを保存する |
lolipop logout | ログアウトして認証情報を削除する |
lolipop health | API サーバーの稼働状態を確認する |
lolipop frameworks list | 利用できる framework の一覧を表示する |
lolipop project | project の作成、一覧、詳細、link などを操作する |
lolipop domain | 独自ドメインの追加、一覧、詳細、検証、削除を行う |
lolipop build-config | ビルド設定の表示と更新を行う |
lolipop deploy | アプリをデプロイする |
lolipop skill install | コーディングエージェントに skill を設置する |
一覧・詳細・更新・デプロイなどの出力系コマンドでは、--json を付けると機械処理しやすい JSON 1 行で出力します。
login
ブラウザを開いてロリポップ！アカウントで認証し、セッションを保存します。
認証情報はローカルの credentials.json（~/.config/lolipop/）に保存されます。
lolipop loginlolipop deploy は未ログインでも自動でログインを開始するため、先に login を実行するかどうかは任意です。
logout
サーバ側のセッションを無効化し、ローカルの認証情報を削除します。
lolipop logouthealth
API サーバーの稼働状態（SERVING / NOT_SERVING / UNKNOWN）を確認します。認証不要です。
lolipop healthframeworks list
利用できる framework の一覧を表示します。
project create や deploy --name で指定する framework 名はここで確認します。
lolipop frameworks listproject
project create
プロジェクトを新規作成します。
サブドメインとビルド設定（BuildConfig）もまとめて作られます。
サブドメインは省略時にプロジェクト名と同じ値になりますが、--domain で別の値を指定できます。
lolipop project create --name <name> --framework <framework>| オプション | 説明 |
|---|---|
--name <name> | プロジェクト名（DNS ラベル形式。未指定なら対話入力） |
--framework <framework> | framework の name（未指定なら一覧から選択） |
--install <cmd> | インストールコマンド（省略時は framework の既定値） |
--build <cmd> | ビルドコマンド（省略時は framework の既定値） |
--output <dir> | ビルド成果物の出力ディレクトリ（省略時は framework の既定値） |
--root <dir> | ビルドを実行するディレクトリ（monorepo 用、省略時はリポジトリルート） |
--domain <label> | サブドメイン（省略時は name と同じ） |
project list
自分が所有するプロジェクトの一覧を表示します（ページング対応）。
lolipop project list| オプション | 説明 |
|---|---|
--page-size <n> | 1 ページあたりの件数（1〜100、省略時は 50） |
--page-token <token> | 前回の出力に含まれる next_page_token（初回は省略） |
project show
プロジェクトの詳細（プロジェクト情報 / サブドメイン / 最新のデプロイ / ビルド設定）を表示します。
lolipop project show --project <id>--project を省略すると .lolipop/project.json、無ければ一覧から選択します。
project link / unlink
カレントディレクトリをプロジェクトに link すると、.lolipop/project.json が作られ、以後 --project を省略できます。
lolipop project link <id> # cwd をプロジェクトに紐付け
lolipop project unlink # link を解除link は親ディレクトリを辿らず、カレントディレクトリのみを対象にします。
project status
現在対象となるプロジェクト（id / name / 解決元）を表示します。
lolipop project statusproject logs
デプロイのビルドログを表示します。
lolipop project logs --latest # 最新 deploy のログ
lolipop project logs <deployment-id> # deployment を指定| オプション | 説明 |
|---|---|
--latest | 最新の deployment のログを表示する（非対話でも使える） |
--project <id> | deployment id 省略時に使うプロジェクトの id |
domain
domain create
プロジェクトに独自ドメインを追加し、設定すべき DNS レコードを表示します。
lolipop domain create www.example.com旧名の lolipop domain add も別名として使えます（create と同じ動作です）。
追加した直後のドメインは「未設定」の状態です。
表示されたレコードをお使いの DNS プロバイダーで設定し、lolipop domain verify で検証を実行すると「有効」になります。
検証はダッシュボードのプロジェクト詳細画面の「ドメイン」タブからも実行できます。
レコードの設定方法は独自ドメインを参照してください。
| オプション | 説明 |
|---|---|
--project <id> | 追加先プロジェクトの id（省略時は link から解決、無ければ一覧から選択） |
domain list
プロジェクトの独自ドメインの一覧（ドメイン / 状態 / 検証日時）を表示します。
lolipop domain list --project <id>--json を付けると、各ドメインに設定すべき DNS レコードも含めて出力します。
domain show
独自ドメインの詳細と、設定すべき DNS レコードを表示します。 追加時に表示されたレコードをあとから確認し直すときに使います。
lolipop domain show www.example.com --project <id>ドメインを省略すると、プロジェクトの独自ドメイン一覧から選択できます。
domain verify
DNS レコードの設定後に、独自ドメインの検証を開始します。
lolipop domain verify www.example.com --project <id>検証は非同期で進むため、コマンド直後のドメインは「検証中」の状態です。
完了すると「有効」になります。
検証の結果は lolipop domain show で確認できます。
DNS レコードが確認できない場合はエラーになります。
設定を見直してから再度実行してください。
ドメインを省略すると、プロジェクトの独自ドメイン一覧から選択できます。
domain delete
独自ドメインをプロジェクトから削除します。
lolipop domain delete www.example.com --project <id>削除は取り消せないため、実行前に確認を求めます。確認をスキップするには --yes を付けます。
パイプや CI などの非対話環境では確認プロンプトを出せないため、--yes の指定が必須です。
ドメインを省略すると、プロジェクトの独自ドメイン一覧から選択できます。
| オプション | 説明 |
|---|---|
--project <id> | 削除先プロジェクトの id（省略時は link から解決、無ければ一覧から選択） |
--yes | 確認プロンプトを省略して削除する |
build-config
build-config show
プロジェクトのビルド設定を表示します。
lolipop build-config show --project <id>旧名の lolipop build-config get も別名として使えます（show と同じ動作です）。
build-config update
ビルド設定を更新します。 指定した項目のみ変更され、空文字を渡すとその項目を空にします。
lolipop build-config update --project <id> --build "npm run build"| オプション | 説明 |
|---|---|
--framework <framework> | 変更後の framework の name |
--install <cmd> | 変更後のインストールコマンド |
--build <cmd> | 変更後のビルドコマンド |
--output <dir> | 変更後の出力ディレクトリ |
--root <dir> | 変更後のビルドを実行するディレクトリ |
deploy
カレントディレクトリ（または --dir）のファイルをプロジェクトにデプロイします。
未ログインなら自動でログインします。
cd <アプリのディレクトリ>
lolipop deployデプロイ先には、すでにあるプロジェクトに再デプロイする場合と、新しくプロジェクトを作ってデプロイする場合があります。
--project / --name を指定せず、ディレクトリもプロジェクトに link していなければ、デプロイ先は対話で決められます。
既存のプロジェクト一覧から選ぶか、その場で新しいプロジェクトを作るかを選びます。
次のオプションを使うと、この選択を非対話で指定できます。
既存のプロジェクトにデプロイする
--project でデプロイ先を指定します。
link 済みのディレクトリなら --project は省略できます。
lolipop deploy --project <id>| オプション | 既定値 | 説明 |
|---|---|---|
--project <id> | デプロイ先プロジェクトの id | |
--dir <dir> | . | デプロイするディレクトリ |
新しいプロジェクトを作ってデプロイする
--name を渡すと、プロジェクトの新規作成とデプロイを同時に行います。
残りのオプションは、このとき作られるプロジェクトの設定です。
lolipop deploy --name <name> --framework <framework>| オプション | 既定値 | 説明 |
|---|---|---|
--name <name> | 新規作成するプロジェクト名 | |
--dir <dir> | . | デプロイするディレクトリ |
--framework <framework> | framework の name | |
--install <cmd> | インストールコマンド | |
--build <cmd> | ビルドコマンド | |
--output <dir> | 出力ディレクトリ | |
--root <dir> | ビルドを実行するディレクトリ（monorepo 用） | |
--domain <label> | サブドメイン |
lolipop deploy は、デプロイ対象のディレクトリをアップロードします。
どのファイルが含まれるか（.env などの扱い、常に除外されるファイル）はデプロイに含まれるファイルを参照してください。
完了すると、デプロイの詳細を確認できるダッシュボードの URL が表示されます。
同じプロジェクトで新しいデプロイを実行すると、そのプロジェクトの進行中（キューイング中やビルド中）のデプロイはキャンセルされ、常に最新のデプロイだけが処理されます。 連続してデプロイした場合は、最後の 1 回だけが公開されます。
skill install
選択したコーディングエージェント（Claude / Codex / Cursor）の skill ディレクトリに、lolipop CLI の skill を設置します。 skill の取得にはログイン済みの認証情報が必要です。
lolipop skill install| オプション | 説明 |
|---|---|
--agent <agents> | 設置先 agent をカンマ区切りで指定（claude,codex,cursor。未指定なら対話選択） |
--scope <scope> | 設置先スコープ（project | global。未指定なら対話選択） |
設置される skill の内容はlolipop CLI スキルで確認できます。
アプリ側の要件
- Next.js は
next.configでoutput: 'standalone'が必須です。これが無いとビルド成果物を公開できません。 - インストール・ビルドコマンドは npm を前提とします。pnpm / yarn には対応していません。
Next.js の設定と注意事項はNext.js をデプロイするを参照してください。