Skip to main content

System requirements

Hardware and software requirements for self-hosting Synjar.

Hardware​

Minimum​

For development and small teams (<10 users):

ResourceMinimum
CPU2 cores
RAM4 GB
Disk20 GB

For production and larger teams:

ResourceRecommended
CPU4+ cores
RAM8+ GB
Disk100+ GB SSD

Scaling notes​

  • CPU scales linearly with concurrent users
  • RAM needed increases with document count
  • Disk usage depends on document storage

Software​

Required​

ComponentVersion
Docker20.10+
OR Node.js20+
PostgreSQL14+
S3-compatible storageAny

Optional​

ComponentPurpose
RedisCaching (improves performance)
SMTP serverEmail notifications
Reverse proxySSL/TLS termination

Network​

Ports​

PortServiceRequired
6200Synjar APIYes
5432PostgreSQLYes
S3 portObject storageYes
25/587SMTPOptional

Outbound access​

Synjar needs outbound access to:

  • OpenAI API (api.openai.com)
  • S3 storage endpoint
  • SMTP server (if configured)

Database​

PostgreSQL​

  • Version 14 or higher
  • pgvector extension (auto-installed)
  • 1 GB minimum allocated storage

Connection requirements​

  • SSL recommended for remote connections
  • Connection pooling recommended for production (PgBouncer)

Storage​

S3-compatible storage​

Synjar stores documents in S3-compatible storage:

  • AWS S3
  • Backblaze B2 (recommended for cost)
  • MinIO (self-hosted)
  • Google Cloud Storage (S3 compatibility mode)

Storage sizing​

DocumentsEstimated storage
100~500 MB
1,000~5 GB
10,000~50 GB

Actual size varies by document type and size.

OpenAI API​

Synjar requires OpenAI API access for:

  • Generating embeddings
  • Semantic search

API requirements​

  • Valid API key
  • Access to text-embedding-ada-002 model
  • Sufficient API credits

Estimated API costs​

DocumentsMonthly cost (approx)
100$0.10
1,000$1.00
10,000$10.00

Based on average document size. Actual costs vary.

See also​