Başlarken

Antimatter'ı kendi sunucunuzda çalıştırın

Tek dosya, üç komut, yaklaşık on dakika: Docker yüklü herhangi bir Linux sunucusunda veritabanı, dosya depolama alanı ve GIF hizmetiyle birlikte Antimatter.

On dakikada kullanıma hazır

Docker ve Compose eklentisi yüklü, en az 2 CPU çekirdeği ve 4 GB belleğe sahip bir Linux sunucusuna ihtiyacınız var.

1. Compose dosyasını indirin

$ mkdir antimatter && cd antimatter
$ curl -fsSLO https://antimatter.chat/compose.yaml

2. Rastgele parolalarla ayarları oluşturun

$ cat > .env <<EOF
SITE_URL=http://localhost:8065
POSTGRES_PASSWORD=$(openssl rand -hex 24)
S3_SECRET_KEY=$(openssl rand -hex 24)
GIFS_API_KEY=$(openssl rand -hex 24)
EOF

SITE_URL değerini, kullanıcıların erişeceği adres olarak ayarlayın; örneğin yerel bir ağda http://192.168.1.20:8065.

3. Başlatın

$ docker compose up -d

Veritabanı oluşturulurken ilk başlatma bir iki dakika sürer. Ardından tarayıcınızda SITE_URL adresini açın ve hesabınızı oluşturun: ilk hesap sistem yöneticisi olur ve kurulum sihirbazı ilk topluluğunuzu oluşturmanızda size yol gösterir.

Kendi alan adınız ve HTTPS ile

Alan adınızın bir DNS kaydını sunucuya yönlendirin, 80 ve 443 numaralı bağlantı noktalarını açın ve alan adını .env dosyasına ekleyin:

$ cat >> .env <<EOF
DOMAIN=chat.example.com
EOF
$ sed -i 's|^SITE_URL=.*|SITE_URL=https://chat.example.com|' .env
$ docker compose --profile https up -d

Caddy, Let's Encrypt'ten bir sertifika alır ve onu kendiliğinden yeniler.

Neler çalışır?

  • antimatter: uygulamalarıyla birlikte sunucu (notlar, beyaz tahtalar, ses kanalları, aramalar, anketler ve diğerleri). Diskte hiçbir şey tutmaz: ayarları veritabanında, dosyaları depolama hizmetindedir; bu nedenle kapsayıcı istediğiniz zaman değiştirilebilir.
  • postgres: veritabanı.
  • files: yüklenen dosyalar için S3 uyumlu depolama sağlayan RustFS.
  • gifs: Antimatter'ın, başlangıç çıkartma paketiyle gelen GIF ve çıkartma hizmeti.
  • https: Caddy; yalnızca https profiliyle çalışır.

Veritabanı, depolama ve GIF hizmeti, yalnızca Antimatter'ın erişebildiği özel bir ağda bulunur.

GIF seçici boş kalırsa Sistem Konsolu › Uygulama ekleri › GIFs sayfasını açın; hizmet URL'sini http://gifs:8080/v2, API anahtarını da .env dosyanızdaki GIFS_API_KEY değeri olarak ayarlayın.

Güncellemeler ve yedekler

# en son imajlara güncelleyin
$ docker compose pull && docker compose up -d
# veritabanını yedekleyin
$ docker compose exec postgres pg_dump -U antimatter antimatter > antimatter.sql

files birimini de yedekleyin ya da depolama alanını herhangi bir S3 aracıyla çoğaltın. nginx ve kendi sertifikalarınızla bir kurulum için antimatter-docker deposundaki üretim dosyalarına bakın.

Sürüm arşiviyle

  1. Bir PostgreSQL veritabanı ve kullanıcısı oluşturun.
  2. Arşivi (antimatter-<os>-<arch>.tar.gz) örneğin /opt/antimatter dizinine açın ve config/config.json dosyasındaki SqlSettings.DataSource ayarını (ya da AM_SQLSETTINGS_DATASOURCE ortam değişkenini) veritabanını gösterecek şekilde ayarlayın.
  3. Sunucuyu ayrıcalıksız bir kullanıcı olarak bin/antimatter ile başlatın ve http://localhost:8065 adresini açın. Oluşturulan ilk hesap sistem yöneticisi olur.

bin/amctl, çalışan bir sunucuyu komut satırından yönetir (sunucunun kendisinde, ServiceSettings.EnableLocalMode açıkken bin/amctl --local).

Sonraki adımlar

  • Aramalar: sesin ve görüntünün sunucuya ulaşması için arama bağlantı noktasını (varsayılan olarak UDP ve TCP 8443) açın.
  • E-posta: davetler ve bildirimler için SMTP'yi yapılandırın.
  • Yapay zeka: Agents ayarlarına bir model ekleyin; kendi çalıştırdığınız bir sunucu da dahil, OpenAI uyumlu her API çalışır.
  • Ses ve çeviri: arama transkripsiyonunu, sesli okumayı ve otomatik çeviriyi, kendi çalıştırdığınız konuşmadan metne, metinden konuşmaya ve çeviri modellerine yönlendirin.