インストールガイド

LoPiQ を macOS または Linux にインストールする手順を説明します。

---

🍎 macOS へのインストール

macOS では、提供される DMGパッケージ（.dmg）を使用してインストールを行います。

👉 LoPiQ v1.16.10 (macOS) - lopiq_1.16.10_mac.dmg をダウンロード

💻 CLI (ターミナル) でダウンロード:

• バージョンを指定してダウンロードする場合:

  curl -L -O https://lopiq.app.hack-le.com/downloads/lopiq_1.16.10_mac.dmg
  

• 常時最新版をダウンロードする場合:

  curl -L -O https://lopiq.app.hack-le.com/downloads/lopiq_latest_mac.dmg
  

インストール手順

1. DMGファイルの展開 ダウンロードした lopiq_1.16.10_mac.dmg ファイルをダブルクリックしてマウントします。
2. アプリケーションフォルダへの配置 表示されたウィンドウ内で、LoPiQ アイコンを右側の Applications フォルダへドラッグ＆ドロップします。
3. 初回起動手順 (未署名アプリの実行許可)
   1. Finder で /Applications を開きます。
   2. LoPiQ.app を 右クリック（または Control キーを押しながらクリック） し、「開く」を選択します。
   3. 警告ダイアログで「開く」を選択すると起動が許可されます。
   4. 自動的にブラウザで http://localhost:13180 が開きます。

アップデート手順

1. 画面右上の 🔄（アップデート）バッジから最新版をダウンロードし、同じ画面の「🛑 アプリを終了」ボタンをクリックしてアプリを停止します。（または ⚙️ 設定から終了）
2. ダウンロードした新しい DMG をマウントし、/Applications へドラッグ＆ドロップして上書きします。

アンインストール手順

1. /Applications/LoPiQ.app をゴミ箱へ移動して削除します。
2. 設定ファイルを消去したい場合は以下を削除します：

   rm -rf ~/Library/Application\ Support/lopiq
   

---

🐧 Linux (Debian/Ubuntu/Mint) へのインストール

Linux 環境向けには、Debian パッケージ（.deb）を使用してインストール管理を行います。

👉 LoPiQ v1.16.10 (Debian/Ubuntu/Mint) - lopiq_1.16.10_amd64.deb をダウンロード

💻 CLI (ターミナル / SSH) でダウンロード:

• バージョンを指定してダウンロードする場合:

  curl -L -O https://lopiq.app.hack-le.com/downloads/lopiq_1.16.10_amd64.deb
  

• 常時最新版をダウンロードする場合:

  curl -L -O https://lopiq.app.hack-le.com/downloads/lopiq_latest_amd64.deb
  

インストール手順 (Debian / Ubuntu / Mint)

• 🖥️ デスクトップ環境 (GUI): .deb ファイルをダブルクリックして App Center / Gdebi 等でインストールします。アプリ一覧から「LoPiQ」を起動できます。

• 💻 ターミナル / サーバー (CLI):

  sudo dpkg -i lopiq_1.16.10_amd64.deb
  systemctl --user enable --now lopiq.service
  

  OS 起動時の自動常駐 (Linger)

  未ログイン時でも常時自動起動させたい場合は以下を実行します：

  loginctl enable-linger $USER
  

サービス管理コマンド

systemctl --user status lopiq.service   # 状態確認
systemctl --user restart lopiq.service  # 再起動
systemctl --user stop lopiq.service     # 停止
journalctl --user -u lopiq.service -f   # ログ監視

アップデート手順

通常は Web UI の右上に表示される 「アップデート」バッジ をクリックし、「アップデートを実行」 ボタンを押すだけで自動的にアップデートされ、サービスが再起動します。

ターミナルから手動でアップデートする場合は、最新の .deb ファイルをダウンロードして上書きインストールしたあと、サービスを再起動してください。

curl -L -O https://lopiq.app.hack-le.com/downloads/lopiq_latest_amd64.deb
sudo dpkg -i lopiq_latest_amd64.deb
systemctl --user restart lopiq.service

アンインストール手順

1. サービスを停止します。

   systemctl --user stop lopiq.service
   systemctl --user disable lopiq.service
   

2. パッケージを削除します。

   sudo dpkg --purge lopiq
   

3. 設定ファイルを完全に消去したい場合は、ユーザーディレクトリ内の以下を削除します。

   rm -rf ~/.config/lopiq
   

---

🧭 次のステップ

• 使い方ガイド — 基本操作・フルサイズ閲覧・キー操作・ZIPダウンロード