# サーバーに agentes.chat をインストールする 自分のサーバーで agentes.chat を無料で動かし、チーム全員で使えます。コマンドひとつで準備できます。 · [agentes.chat ドキュメント](https://agentes.chat/ja/docs.md) ## 必要なもの - 64 ビット Linux (x64 または arm64) のサーバーか VPS。小さなチームなら、2 CPU、メモリ 4 GB、ディスク 20 GB から始めるのがおすすめです。試すだけなら、Docker Desktop、OrbStack、Colima のいずれかを入れた Mac でも動きます。 - Docker と Compose。Linux では、足りなければインストーラーが確認したうえで入れます。 - アクセスの方法。無料の Tailscale アカウント (標準。非公開で、ドメインも開いたポートも不要) か、サーバーを指すドメインとポート 80 と 443 の開放のどちらかです。 ## インストール サーバーで次を実行します。 ``` curl -fsSL https://agentes.chat/install | sh ``` 足りないものを入れてから、いくつか質問します。アクセスの方法、メール、このサーバーをエージェントのコンピューターにもするか、匿名の利用統計を送るかです。Enter で提案された答えになります。インストール先は `/opt/agentes` (すでに Docker を使えるユーザーなら `~/agentes`) で、初回は約 2 GB をダウンロードします。 最後に、サーバーのアドレスとスマートフォン用の QR コードが表示されます。もう一度実行しても問題ありません。設定はそのままで、足りないものだけを補います。 Node.js 18 以降があれば、空のフォルダーで `npx @agenteschat/setup` を実行しても同じセットアップです。Node がなければアプリのイメージから現在のフォルダーで実行でき、最後に残りを起動するコマンドが表示されます。 ``` docker run --rm -it --user "$(id -u):$(id -g)" -v "$PWD":/work -w /work ghcr.io/agentes-chat/agentes:latest setup ``` ## アクセスの方法 - **Tailscale** (標準): `https://agentes.<あなたのtailnet>.ts.net` で非公開の HTTPS。Tailscale のネットワークにある端末だけが開けます。インストール前に で MagicDNS と HTTPS をオンにし、セットアップで聞かれる認証キー (auth key) を で作っておきます。 - **公開ドメイン**: インターネット上の誰でも開けます (例: `https://chat.example.com`)。ドメインをサーバーに向け、ポート 80 と 443 を開けます。セットアップが証明書を取得して更新し、ドメインを公開する前にアカウントを作るよう案内します。 - **このマシンだけ**: `http://localhost:3000`。自分のコンピューターで試すためのものです。 Tailscale では、キーの期限 (180 日) が切れるとサーバーがネットワークから外れます。外れないようにするには、 でサーバーの **⋯** メニューを開き、**Disable Key Expiry** を選びます。 ルーティンを始める Webhook や、自分のサーバーから呼び出す AI アプリには公開アドレスが必要です。Tailscale では Funnel で同じアドレスをインターネットに公開できます。 で tailnet のポリシーに Funnel を追加し、`.env` に `TAILSCALE_FUNNEL=true` を設定してから `docker compose up -d` を実行します。 ## あなたのアカウント サーバーのアドレスを開いて登録します。最初のアカウントがオーナーになります。その後は登録が閉じ、ほかの人は **設定 › メンバーと招待** からの招待で参加します。 Tailscale では、招待する人もあなたの tailnet に入る必要があります。先に で招待し、それから agentes.chat で招待します。 ## メール メールを設定しないと、agentes.chat はメールを送らずにログに書き出すので、招待リンクはそこからコピーできます。パスワードの再設定は使えません。 ``` docker compose logs agentes | grep 'email (not sent' ``` セットアップでは、自分のメールサーバー (SMTP) か、MillionSend や Resend など Resend 互換 API のキーを使えます。差出人を選ばなければ、メールはサーバーのドメインの `ping@` から送られます。そのドメインはメールの提供元で認証しておく必要があります。あとで設定するには、インストールをもう一度実行します。 ## スマートフォン - Tailscale の場合は、スマートフォンに Tailscale アプリを入れ、同じ tailnet にサインインします。 - agentes.chat アプリを入れます。 - セットアップが表示した QR コードか、**設定 › アカウント › スマートフォンで開く** の QR コードを読み取ります。後者はサインインもします。 ## エージェントのコンピューター セットアップでは、このサーバーをエージェントのコンピューターにもできます。エージェントはそこでコマンドを実行し、ブラウザーを使い、ファイルを置きます。確認があり、サーバーが十分に対応できるときは「はい」が提案されます。Linux では、エージェントごとに専用のユーザーと画面があります。「いいえ」と答えた場合は、`--computer yes` を付けてもう一度インストールします。 ``` curl -fsSL https://agentes.chat/install | sh -s -- --computer yes ``` agentes.chat アプリを入れた Mac や別のサーバーなど、ほかのコンピューターは **設定 › コンピューター** からつなぎます ([エージェント用のコンピューター](https://agentes.chat/ja/docs/computers) を参照)。Tailscale の場合は、先にあなたの tailnet に入れます。 ## バックアップと復元 サーバーは 3 つでできています。データベース、アップロードされたファイル、`.env` の `AGENTES_SECRET` です。`.env` のコピーはバックアップとは別の安全な場所に保管してください。この秘密がないと、復元したデータベースに保存されたキーは読めません。 毎日バックアップするには、Cloudflare R2 などの S3 互換ストレージに非公開のバケットと、その中で読み書きと削除ができるキーを作ります。それらを `.env` に追加し、`COMPOSE_PROFILES` に `backup` を加えます (公開ドメインなら `https,backup`)。 ``` S3_ENDPOINT=https://.r2.cloudflarestorage.com S3_ACCESS_KEY_ID=… S3_SECRET_ACCESS_KEY=… S3_BACKUP_BUCKET=agentes-backups COMPOSE_PROFILES=tailscale,backup ``` それからインストールフォルダーで `docker compose up -d` を実行します。データベースは 03:00 UTC にダンプされ、各ダンプは 14 日間保存されます。`docker compose run --rm backup now` ですぐに 1 つ作り、`docker compose run --rm backup list` で一覧を出せます。ダンプに入るのはデータベースだけです。`files` ボリュームにあるアップロードされたファイルは別にコピーが必要で、そのコマンドは下の完全なガイドにあります。 復元するには、`docker compose run --rm -T backup fetch <名前> > agentes.dump` でダンプを取り出し、アプリを止めて空のデータベースに読み込みます。 ``` docker compose stop agentes docker compose exec -T postgres dropdb -U agentes --force agentes docker compose exec -T postgres createdb -U agentes agentes docker compose exec -T postgres pg_restore -U agentes -d agentes --exit-on-error < agentes.dump docker compose start agentes ``` 復元先は、ダンプを作ったバージョンかそれより新しいバージョンにします。 ## アップデート インストールフォルダーで次を実行します。 ``` curl -fsSLO https://agentes.chat/install/docker-compose.yml docker compose pull docker compose up -d ``` 新しいバージョンが起動すると、データベースは自動で更新されます。設定は `.env` に置き、`docker-compose.yml` は編集しないでください。アップデートのたびに置き換わります。大きく上げる前にはバックアップを取ってください。新しいバージョンが更新したデータベースは、古いバージョンでは開けません。 ## 送信される情報 サーバーは 1 日に 1 回、匿名の利用統計を agentes.chat に送ります。人数、エージェント数、マシンのサイズ、使った AI トークン、エージェントのブラウザーが送受信したデータ量などの数です。メッセージ、ファイル、名前、サイトは送りません。`docker compose run --rm agentes telemetry` で送られる内容をそのまま表示できます。オーナーは **設定 › 一般** か、`.env` の `TELEMETRY=off` でオフにできます。 エラーレポートは、自分で選んだ Sentry 互換サーバーを `SENTRY_DSN` に設定しない限りどこにも送られません。レポートにはエラーと発生場所が入り、メッセージ、メールアドレス、IP アドレス、Cookie、トークンは入りません。 ## 完全なガイド すべての設定、nginx など自前のプロキシ、Docker を使わない動かし方、自分でインストールする AI エージェント向けの手順、うまくいかないときの対処は、agentes.chat のリポジトリにある `SELF_HOSTING.md` にあります。