Chatbot Kit

Deployment Overview

Deploy your Chatbot Kit application to production with flexible options ranging from simple Docker deployments to fully managed solutions.

Quick Deployment with Docker Compose

Thanks to the included docker-compose.yml, you can deploy Chatbot Kit anywhere that supports Docker with minimal configuration changes.

Environment Configuration

For production deployment, update these key variables in your docker-compose.yml:

Security Settings:

QDRANT__SERVICE__API_KEY=your_production_secret_key
N8N_ENCRYPTION_KEY=your-production-encryption-key
N8N_USER_MANAGEMENT_JWT_SECRET=your-production-jwt-secret

Generate secure secrets:

# Generate random secrets for production
openssl rand -hex 32

Frontend Environment Variables

Update your .env file for production:

NEXT_PUBLIC_API_BASE_URL=https://your-domain.com/webhook
NEXT_PUBLIC_ASSETS_BASE_URL=https://your-cdn-domain.com

The same Docker setup from development works seamlessly in production - just adjust these variables according to your infrastructure.

One-Click Deployment Solution

For a simple, quick production setup, we recommend using Elestio - a managed cloud platform that handles all the infrastructure complexity for you.

📚 Follow our Elestio Deployment Guide →

Elestio provides:

  • CI/CD integration for the frontend
  • One click install for managed services (n8n, Qdrant, Valkey)
  • SSL certificates and domain management
  • Built-in monitoring and backups
  • One-click updates and scaling

CDN Integration for Optimal Performance

Why Use a CDN

For production deployments, implementing a CDN (Content Delivery Network) is crucial for:

  • Faster asset loading - Images, 3D models, and audio files served from global edge locations
  • Reduced server load - Static assets offloaded from your main application server
  • Better user experience - Faster page loads, especially for international users
  • Cost optimization - Lower bandwidth costs on your primary server

Recommended CDN Solutions

Option 1: Cloudflare R2 + CDN

  • Cost-effective object storage with global CDN
  • Easy integration with Cloudflare's edge network
  • No egress fees for bandwidth
  • S3-compatible API for easy setup

Option 2: AWS S3 + CloudFront

  • Industry-standard solution with robust features
  • Advanced caching and distribution controls
  • Seamless AWS ecosystem integration

Assets Sync Implementation

You can create a script to sync your /public folder to your CDN storage.

My personal setup is in a different folder to have a link named chatbot-kit to my /public folder and a script to sync it to my CDN provider. It automatically synchronizes all files including new, updated, and deleted files onto https://assets.wawasensei.dev/chatbot-kit/....

1. Upload static assets:

# Example script to sync assets to your CDN
npm run assets-sync

This script pushes all files from your /public folder to your configured CDN storage.

My assets-sync script uses the aws s3 sync command to upload files to an R2 Storage (S3 compatible), but you can adapt it for other providers.

2. Configure CDN URL:

# Point to your CDN for production asset delivery
NEXT_PUBLIC_ASSETS_BASE_URL=https://your-cdn-domain.com

3. Asset resolution:

  • Development: Assets served directly from /public
  • Production: Assets loaded from CDN using NEXT_PUBLIC_ASSETS_BASE_URL

CDN Setup Process

  1. Choose your CDN provider (Cloudflare R2, AWS S3, etc.)
  2. Create storage bucket and configure public access for static assets
  3. Set up CDN distribution pointing to your storage bucket
  4. Configure assets-sync script with your CDN credentials
  5. Deploy assets using the sync script
  6. Update environment variables to use CDN URLs

Professional Deployment Services

Need help with deployment or want a fully managed solution? Our team can handle the entire deployment process for you.

What we provide:

  • Complete infrastructure setup and configuration
  • CDN integration and optimization
  • Security hardening and best practices
  • Performance monitoring and analytics
  • Ongoing maintenance and support
  • Custom deployment solutions for enterprise needs

Contact us: contact@wawasensei.dev

Deployment Checklist

Before Deployment

  • Generate production secrets for all services
  • Configure CDN and upload assets
  • Update environment variables for production URLs
  • Test all n8n workflows with production credentials
  • Verify SSL certificates and domain configuration
  • Set up monitoring and logging
  • Configure backup procedures for databases
  • Enable billing alerts and limits on LLM/TTS services

Security Considerations

  • Use strong, unique secrets for all services
  • Enable HTTPS/SSL for all endpoints
  • Configure proper firewall rules
  • Implement rate limiting and DDoS protection
  • Regular security updates for all services
  • Secure credential storage and rotation

Performance Optimization

Whether you choose self-deployment or professional services, Chatbot Kit provides the flexibility and support you need to successfully launch your 3D AI chatbot in production.

Next

Elestio