SnapOtter/apps/docs/ja/guide/getting-started.md

description, i18n_source_hash, i18n_provenance, i18n_output_hash, i18n_hash_version

description	i18n_source_hash	i18n_provenance	i18n_output_hash	i18n_hash_version
1 つのコマンドで SnapOtter を Docker でインストールします。Docker Compose のセットアップ、ソースからのビルド、機能の全体像を含みます。	8040133a6982	machine	254b9e41e358	2

はじめに

::: tip インストール前に試す demo.snapotter.com で完全な UI を試せます。サインアップもインストールも不要です。 :::

クイックスタート

docker run -d --name SnapOtter -p 1349:1349 -v SnapOtter-data:/data snapotter/snapotter:latest

この単一のコンテナーは必要なものをすべて実行します。DATABASE_URL を設定せずに、ループバック インターフェイス (埋め込みモード) で独自の PostgreSQL と Redis を開始し、すべてのデータを SnapOtter-data ボリュームに保持します。これは、ホームラボで SnapOtter またはセルフホストを試す最も速い方法です。運用環境では、PostgreSQL と Redis を独自のコンテナーに保持する 正規の Docker Compose スタック を使用します。埋め込みモードは root (デフォルト) として実行され、DATABASE_URL を設定するとすぐに自動的にオフになります。

Raspberry Pi、古いラップトップ、小さな VPS にインストールしますか？調整済みの手順と、限られたハードウェアで何が期待できるかについては、低リソース環境のセットアップ を参照してください。

初回ログイン時にパスワードの変更を求められます。

::: tip 匿名のプロダクトアナリティクス SnapOtter にはデフォルトで匿名のプロダクトアナリティクスが含まれています。オフにするには、Settings → System → Privacy を開き、Anonymous Product Analytics をオフにしてください。インスタンス全体で即座に停止します。

環境変数 SNAPOTTER_TELEMETRY=0（false と off も使えます）を設定すると、リビルドせずにインスタンスのすべてのテレメトリを無効にできます。

エラー監視は Sentry によって提供されており、Sentry はオープンソースプログラムを通じて SnapOtter をスポンサーしています。

何が収集されるかの詳細については、SnapOtter が収集するもの を参照してください。 :::

::: tip NVIDIA CUDA アクセラレーション NVIDIA CUDA で高速化された背景除去、アップスケーリング、顔の強調、および復元用に --gpus all を追加します。 OCR は CPU ベースのままで、GPU アクセスの有無にかかわらず、同じイメージ内で動作します。

docker run -d --name SnapOtter -p 1349:1349 --gpus all -v SnapOtter-data:/data snapotter/snapotter:latest

NVIDIA Container Toolkit が必要です。 CUDA が使用できない場合は、自動的に CPU にフォールバックします。現在、VA-API、Quick Sync、または OpenCL を介した Intel/AMD iGPU アクセラレーションは AI 推論ではサポートされていません。ベンチマークについては、Docker タグ を参照してください。 --gpus all にもかかわらず AI ツールが CPU で実行される場合は、GPU アクセラレーションを検証する を参照してください。 :::

::: details GHCR でも利用可能

docker run -d --name SnapOtter -p 1349:1349 -v SnapOtter-data:/data ghcr.io/snapotter-hq/snapotter:latest

どちらのレジストリもリリースごとに同じイメージを公開します。 :::

Docker Compose

このページから短縮された Compose サンプルをコピーする代わりに、各リリースで保守およびテストされた実稼働ファイルを使用してください。

install -d -m 700 snapotter && cd snapotter
curl --proto '=https' --tlsv1.2 -fsSLo docker-compose.yml \
  https://raw.githubusercontent.com/snapotter-hq/SnapOtter/v2.2.0/docker/docker-compose.yml

# Keep generated service credentials out of shell history and world-readable files.
umask 077
POSTGRES_PASSWORD="$(openssl rand -hex 32)"
REDIS_PASSWORD="$(openssl rand -hex 32)"
printf 'POSTGRES_PASSWORD=%s\nREDIS_PASSWORD=%s\n' \
  "$POSTGRES_PASSWORD" "$REDIS_PASSWORD" > .env

docker compose -f docker-compose.yml pull
docker compose -f docker-compose.yml up -d --no-build

正規の docker/docker-compose.yml には、4 つのランタイム ボリュームすべて、ヘルス チェック、リソース制限、耐久性のある Redis 構成、固定されたデータベース/キャッシュ イメージ、および現在のコンテナーの強化が含まれています。最初のログイン直後にデフォルトの管理者パスワードを変更します。再現可能な展開を行うには、latest をフォローする代わりに、SnapOtter アプリケーション イメージをリリース タグまたは確認したダイジェストに固定します。

すべての環境変数については 構成 を、シークレット、ネットワーク ポリシー、およびバックアップ ガイダンスについては セキュリティと強化 を参照してください。

ソースからビルド

前提条件: Node.js 22.22 以上、pnpm 9 以上、Docker（Postgres + Redis 用）、Python 3.10 以上（AI 機能用）、Git。

git clone https://github.com/snapotter-hq/SnapOtter.git
cd SnapOtter
docker compose -f docker-compose.dev.yml up -d   # start Postgres + Redis
pnpm install
pnpm dev

• フロントエンド: http://localhost:1351
• バックエンド: http://localhost:13490

できること

ファイル処理（200+ ツール）

モダリティ	数	ツールの例
画像	107	リサイズ、切り抜き、圧縮、変換、背景除去、アップスケール、OCR、透かし、コラージュ、カラー化、GIF ツール、フォーマットプリセット
ビデオ	57	トリミング、切り抜き、圧縮、変換、結合、オーディオ抽出、自動字幕、ビデオから GIF、リサイズ、手ブレ補正、フォーマットプリセット
オーディオ	27	トリミング、結合、変換、正規化、ノイズ低減、文字起こし、ピッチシフト、フェード、着信音メーカー、フォーマットプリセット
PDF / ドキュメント	29	結合、分割、圧縮、OCR、透かし、墨消し、Word から PDF、Excel から PDF、回転、保護、修復
ファイル	23	CSV から JSON、JSON から XML、CSV の結合、CSV の分割、ZIP の作成、ZIP の展開、チャートメーカー、YAML/JSON

パイプライン

ツールを連結して複数ステップのワークフローにし、1 枚の画像やバッチ全体に適用します：

1. サイドバーで Pipelines を開きます。
2. ステップを追加します（任意のツール、任意の設定）。
3. 単一ファイルで実行するか、バッチ全体を一度に実行します。
4. パイプラインを保存して後で再利用します。

パイプラインはデフォルトで 20 ステップを許可します。MAX_PIPELINE_STEPS=0 を設定すると上限を無制限にできます。

ファイルライブラリ

処理したすべてのファイルは Files ライブラリに保存できます。SnapOtter は完全なバージョン履歴を追跡するので、元のアップロードから最終出力まで、あらゆる処理ステップを辿れます。

保存は明示的です。ライブラリに保存した結果は削除するまで保持されますが、処理して未保存のまま残した結果は 72 時間後に自動的に消去されます（FILE_MAX_AGE_HOURS で設定可能）。

REST API と API キー

すべてのツールは HTTP 経由でアクセスできます：

curl -X POST http://localhost:1349/api/v1/tools/image/resize \
  -H "Authorization: Bearer si_<your-api-key>" \
  -F "file=@photo.jpg" \
  -F 'settings={"width":800,"height":600,"fit":"cover"}'

Settings → API Keys で API キーを生成します。すべてのエンドポイントについては REST API リファレンス を参照するか、http://localhost:1349/api/docs でインタラクティブなリファレンスにアクセスしてください。

マルチユーザーとチーム

ロールベースのアクセス制御で複数のユーザーを有効にします：

• 管理者（Admin）: フルアクセス。ユーザー、チーム、設定、すべてのファイル/パイプライン/API キーを管理します
• ユーザー（User）: ツールを使用し、自分のファイル/パイプライン/API キーを管理します

Settings → Teams でチームを作成してユーザーをグループ化します。

AUTH_ENABLED=true（ログインなしの単一ユーザー/自己利用の場合は false）を設定します。