Dokumentacja
Polski

Zainstaluj agentes.chat na serwerze

Uruchom agentes.chat na własnym serwerze, za darmo, dla całego zespołu. Jedno polecenie wszystko przygotowuje.

Czego potrzebujesz

  • Serwera lub VPS z 64-bitowym Linuksem, na x64 albo arm64. Dla małego zespołu 2 CPU, 4 GB pamięci i 20 GB dysku to dobry początek. Do wypróbowania wystarczy też Mac z Docker Desktop, OrbStack albo Colima.
  • Dockera z Compose. Na Linuksie instalator dodaje je, gdy ich brakuje, po zapytaniu.
  • Sposobu dostępu: darmowego konta Tailscale (domyślnie, prywatnie, bez domeny i bez otwartego portu) albo domeny wskazującej na serwer, z otwartymi portami 80 i 443.

Instalacja

Na serwerze uruchom:

curl -fsSL https://agentes.chat/install | sh

Instaluje to, czego brakuje, a potem zadaje kilka pytań: jak ludzie się do niego dostaną, o e-mail, czy ten serwer ma być też komputerem twoich agentów i czy wysyłać anonimowe statystyki użycia. Enter wybiera proponowaną odpowiedź. Instaluje się w /opt/agentes (~/agentes dla użytkownika, który już może używać Dockera), a za pierwszym razem pobiera około 2 GB.

Na końcu pokazuje adres twojego serwera i kod QR dla telefonu. Ponowne uruchomienie jest bezpieczne: zachowuje twoje ustawienia i uzupełnia tylko to, czego brakuje.

Z Node.js 18 lub nowszym npx @agenteschat/setup w pustym folderze to ta sama konfiguracja. Bez Node uruchamia się z obrazu aplikacji, w bieżącym folderze, i kończy się poleceniami, które uruchamiają resztę:

docker run --rm -it --user "$(id -u):$(id -g)" -v "$PWD":/work -w /work ghcr.io/agentes-chat/agentes:latest setup

Jak ludzie się dostają

  • Tailscale, domyślnie: prywatne HTTPS pod https://agentes.<twoj-tailnet>.ts.net, tylko dla urządzeń w twojej sieci Tailscale. Przed instalacją włącz MagicDNS i HTTPS na https://console.tailscale.com/admin/dns i utwórz klucz uwierzytelniania (auth key) na https://console.tailscale.com/admin/settings/keys, o który zapyta konfiguracja.
  • Publiczna domena: każdy w internecie może ją otworzyć, na przykład pod https://chat.example.com. Skieruj domenę na serwer i otwórz porty 80 i 443. Konfiguracja pobiera certyfikat i go odnawia, a przed uruchomieniem domeny prosi o założenie twojego konta.
  • Tylko ta maszyna: http://localhost:3000, żeby wypróbować na własnym komputerze.

W Tailscale serwer wypada z twojej sieci, gdy wygaśnie jego klucz, po 180 dniach. Żeby go zatrzymać, otwórz menu ⋯ serwera na https://console.tailscale.com/admin/machines i wybierz Disable Key Expiry.

Webhooki, które uruchamiają rutyny, i aplikacje AI, które łączą się ze swoich serwerów, potrzebują publicznego adresu. W Tailscale Funnel otwiera ten sam adres na internet: dodaj Funnel do zasad swojego tailnetu na https://console.tailscale.com/admin/acls i ustaw TAILSCALE_FUNNEL=true w .env, potem uruchom docker compose up -d.

Twoje konto

Otwórz adres serwera i zarejestruj się: pierwsze konto zostaje właścicielem. Potem rejestracja się zamyka, a ludzie dołączają przez zaproszenie, z Ustawienia › Członkowie i zaproszenia.

W Tailscale osoby, które zapraszasz, też muszą być w twoim tailnecie. Najpierw zaproś je na https://console.tailscale.com/admin/users a potem w agentes.chat.

E-mail

Bez e-maila agentes.chat zapisuje każdą wiadomość w swoim logu zamiast ją wysłać, więc link z zaproszeniem da się stamtąd skopiować. Resetowanie hasła pozostaje wyłączone.

docker compose logs agentes | grep 'email (not sent'

Konfiguracja przyjmuje twój własny serwer poczty (SMTP) albo klucz API zgodnego z Resend, na przykład MillionSend lub Resend. E-maile wychodzą z ping@ domeny twojego serwera, chyba że wybierzesz innego nadawcę, a ta domena musi być zweryfikowana u twojego dostawcy poczty. Żeby skonfigurować to później, uruchom instalację ponownie.

Twój telefon

  • W Tailscale zainstaluj aplikację Tailscale na telefonie i zaloguj się do tego samego tailnetu.
  • Zainstaluj aplikację agentes.chat.
  • Zeskanuj kod QR, który pokazała konfiguracja, albo ten z Ustawienia › Twoje konto › Otwórz na telefonie, który od razu cię loguje.

Komputery twoich agentów

Konfiguracja może zrobić z tego serwera także komputer twoich agentów, na którym uruchamiają polecenia, używają przeglądarki i trzymają swoje pliki. Pyta o to i proponuje tak, gdy serwer dobrze sobie z tym poradzi. Na Linuksie każdy agent dostaje własnego użytkownika, z ekranem. Jeśli odpowiedziałeś nie, uruchom instalację ponownie z --computer yes:

curl -fsSL https://agentes.chat/install | sh -s -- --computer yes

Kolejne komputery, na przykład Mac z aplikacją agentes.chat albo inny serwer, łączysz w Ustawienia › Komputery, jak w Komputery dla twoich agentów. W Tailscale najpierw dołączają do twojego tailnetu.

Kopie zapasowe i przywracanie

Twój serwer to trzy rzeczy: baza danych, przesłane pliki i AGENTES_SECRET w .env. Trzymaj kopię .env w bezpiecznym miejscu, osobno od kopii zapasowych: bez tego sekretu klucze zapisane w przywróconej bazie są nie do odczytania.

Dla kopii każdego dnia utwórz prywatny bucket w Cloudflare R2 albo innym magazynie zgodnym z S3 oraz klucz, który może w nim czytać, zapisywać i usuwać. Dodaj je do .env, z backup w COMPOSE_PROFILES (https,backup z publiczną domeną):

S3_ENDPOINT=https://<account-id>.r2.cloudflarestorage.com
S3_ACCESS_KEY_ID=…
S3_SECRET_ACCESS_KEY=…
S3_BACKUP_BUCKET=agentes-backups
COMPOSE_PROFILES=tailscale,backup

Potem uruchom docker compose up -d w folderze instalacji. Zrzut bazy powstaje o 03:00 UTC, a każdy jest trzymany 14 dni. docker compose run --rm backup now robi jeden od razu, a docker compose run --rm backup list je wypisuje. Zrzuty zawierają tylko bazę: przesłane pliki, w woluminie files, potrzebują własnej kopii, a pełny przewodnik poniżej ma polecenia.

Żeby przywrócić, pobierz zrzut przez docker compose run --rm -T backup fetch <nazwa> > agentes.dump, a potem wczytaj go do pustej bazy przy zatrzymanej aplikacji:

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

Przywracaj do wersji, która zrobiła zrzut, albo do nowszej.

Aktualizacje

W folderze instalacji uruchom:

curl -fsSLO https://agentes.chat/install/docker-compose.yml
docker compose pull
docker compose up -d

Baza aktualizuje się sama, gdy startuje nowa wersja. Trzymaj ustawienia w .env i nigdy nie edytuj docker-compose.yml, bo każda aktualizacja go zastępuje. Zrób kopię przed dużym skokiem: baza zaktualizowana przez nowszą wersję nie otworzy się w starszej.

Co wysyła

Raz dziennie serwer wysyła do agentes.chat anonimowe statystyki użycia: liczby takie jak osoby, agenci, rozmiary maszyn, zużyte tokeny AI i ile danych wysyłają i odbierają przeglądarki agentów. Nigdy wiadomości, pliki, nazwy ani strony. docker compose run --rm agentes telemetry pokazuje dokładnie, co zostałoby wysłane. Właściciel wyłącza to w Ustawienia › Ogólne albo przez TELEMETRY=off w .env.

Raporty błędów nigdzie nie trafiają, chyba że ustawisz SENTRY_DSN na wybrany przez siebie serwer zgodny z Sentry. Raport zawiera błąd i miejsce, w którym wystąpił, nigdy wiadomości, e-maile, adresy IP, ciasteczka ani tokeny.

Pełny przewodnik

Wszystkie ustawienia, własne proxy takie jak nginx, działanie bez Dockera, instrukcja dla agentów AI, którzy instalują go sami, i co robić, gdy coś zawiedzie, są w SELF_HOSTING.md, w repozytorium agentes.chat.