Skip to main content

Self-Hosting Requirements

Run ArchiCore on your own infrastructure.

System Requirements​

Minimum​

ResourceRequirement
CPU2 cores
RAM4 GB
Storage20 GB SSD
OSLinux (Ubuntu 20.04+), macOS, Windows
ResourceRequirement
CPU4+ cores
RAM8+ GB
Storage50+ GB SSD
OSUbuntu 22.04 LTS

Software Requirements​

Required​

  • Node.js 18.0 or higher
  • Docker 20.10+ (for containerized deployment)
  • PostgreSQL 14+ (for user data)

Optional​

  • Redis 6+ (for caching)
  • Qdrant 1.7+ (for vector search)
  • Nginx (for reverse proxy)

API Keys​

ArchiCore requires external API keys for AI features:

Choose one:

LLM (Required for AI assistant)​

Choose one:

Network Requirements​

Outbound Connections​

ArchiCore needs to reach:

ServiceDomainPort
Jina AIapi.jina.ai443
OpenAIapi.openai.com443
Anthropicapi.anthropic.com443
GitHubapi.github.com443

Inbound (if using webhooks)​

PortPurpose
80/443Web interface
3000API (if not using reverse proxy)

Database Storage​

Estimate storage needs:

DataSize per project
Index metadata~1 MB per 1000 files
Vector embeddings~10 MB per 1000 files
Analysis cache~5 MB per project

Example: A 500-file project needs ~8 MB of storage.

Scaling Considerations​

Single Instance​

Suitable for:

  • Personal use
  • Small teams (< 10 users)
  • < 50 projects

Horizontal Scaling​

For larger deployments:

  • Load balancer in front
  • Multiple ArchiCore instances
  • Shared PostgreSQL
  • Shared Redis
  • Qdrant cluster

Next Steps​