コンテンツにスキップ

インストールガイド

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

🍎 macOS へのインストール

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

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

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

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

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

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

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

インストール手順

  1. DMGファイルの展開 ダウンロードした lopiq_1.14.0_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

🪟 Windows へのインストール

Windows では ZIPパッケージ（.zip）を使用してインストールを行います。

👉 LoPiQ v1.14.0 (Windows) - lopiq_1.14.0_windows_amd64.zip をダウンロード

💻 CLI (PowerShell) でダウンロード: 

Invoke-WebRequest -Uri "https://lopiq.app.hack-le.com/downloads/lopiq_latest_windows_amd64.zip" -OutFile "lopiq_latest_windows_amd64.zip"

インストール手順

  1. ZIP ファイルを解凍し、任意のフォルダ（例: C:\Program Files\LoPiQ 等）に移動します。
  2. lopiq.exe をダブルクリックして起動します。 (SmartScreen 警告が出た場合は「詳細情報」→「実行」を選択)
  3. ブラウザで http://localhost:13180 にアクセスします。

アップデート手順

  1. 画面右上の 🔄（アップデート）バッジから最新版をダウンロードし、同じ画面の「🛑 アプリを終了」ボタンをクリックしてアプリを停止します。
  2. 最新の ZIP パッケージを展開します。
  3. 既存の lopiq.exe を、新しいバージョンのものに上書きして置き換えます。
  4. 再度 lopiq.exe を起動します。

アンインストール手順

lopiq フォルダを削除します。設定も消去する場合は %APPDATA%\lopiq を削除してください。

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

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

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

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

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

    curl -L -O https://lopiq.app.hack-le.com/downloads/lopiq_1.14.0_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.14.0_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ダウンロード