Docs/Self-Hosted
Enterprise Feature

Self-Hosted Deployment

Run Chatmefy on your own infrastructure for complete data control and customization.

Why Self-Host?

Data Sovereignty

Keep all data within your infrastructure and jurisdiction

Full Customization

Modify UI, add custom integrations, extend functionality

Infrastructure Control

Use your existing infrastructure, VPC, and security policies

Air-Gapped Support

Deploy in environments without external internet access

System Requirements

Minimum Specifications

CPU4 vCPUs (8+ recommended)
RAM16 GB (32 GB recommended)
Storage100 GB SSD
Network1 Gbps

Software Requirements

Docker24.0+
Docker Compose2.20+
PostgreSQL15+
Redis7.0+
Node.js20 LTS (for custom builds)

Quick Start

1. Clone the repository
git clone https://github.com/chatmefy/chatmefy-enterprise.git
cd chatmefy-enterprise
2. Configure environment
cp .env.example .env

# Edit .env with your settings:
# - DATABASE_URL=postgres://user:pass@localhost:5432/chatmefy
# - REDIS_URL=redis://localhost:6379
# - OPENAI_API_KEY=sk-...
# - LICENSE_KEY=your-enterprise-license-key
3. Start services
docker-compose up -d

# Check status
docker-compose ps

# View logs
docker-compose logs -f app
4. Access the application
# Default URL: http://localhost:3000
# Default admin: admin@localhost / changeme123

# Run initial setup
docker-compose exec app npm run setup

Architecture

appMain application server (Next.js)3000
workerBackground job processor
postgresPrimary database5432
redisCache and job queue6379
ai-proxyLLM API proxy (optional)8080

Configuration Options

VariableDescriptionRequired
DATABASE_URLPostgreSQL connection stringYes
REDIS_URLRedis connection stringYes
LICENSE_KEYYour enterprise license keyYes
OPENAI_API_KEYOpenAI API key for AI featuresYes
NEXTAUTH_SECRETRandom secret for sessionsYes
NEXTAUTH_URLYour deployment URLYes
SMTP_HOSTEmail server for notificationsNo
S3_BUCKETFile storage bucketNo
SENTRY_DSNError trackingNo

LLM Configuration

Self-hosted supports multiple LLM providers:

OpenAI

GPT-4, GPT-3.5

API key required

Azure OpenAI

GPT-4, GPT-3.5

Azure subscription

Anthropic

Claude 3

API key required

Local LLMs

Llama, Mistral

Ollama or vLLM

Upgrades & Maintenance

Upgrade Process
# Pull latest images
docker-compose pull

# Backup database
docker-compose exec postgres pg_dump -U chatmefy > backup.sql

# Apply migrations
docker-compose exec app npm run migrate

# Restart services
docker-compose up -d

# Verify health
curl http://localhost:3000/api/health

Important

Always backup your database before upgrading. Test upgrades in a staging environment first.

Enterprise Support

Included with License

Installation assistance
Configuration review
Performance optimization
Security hardening guidance
Priority support tickets

Optional Add-ons

On-site deployment assistance
Custom feature development
Dedicated support engineer
24/7 phone support
Penetration testing

Get Started with Self-Hosted

Contact our team to obtain your enterprise license and deployment package.