botserver/docs/src/chapter-14-migration
2025-12-01 02:22:35 -03:00
..
automation.md - Version of publish. 2025-11-25 16:10:50 -03:00
botpress.md Remove documentation files that have been merged into the mdbook 2025-11-30 18:07:22 -03:00
common-concepts.md - SVG UI. 2025-12-01 02:22:35 -03:00
comparison-matrix.md Remove documentation files that have been merged into the mdbook 2025-11-30 18:07:22 -03:00
dialogflow.md Remove documentation files that have been merged into the mdbook 2025-11-30 18:07:22 -03:00
google-workspace.md - SVG UI. 2025-12-01 02:22:35 -03:00
intercom.md - SVG UI. 2025-12-01 02:22:35 -03:00
kb-migration.md - SVG UI. 2025-12-01 02:22:35 -03:00
microsoft-365.md - SVG UI. 2025-12-01 02:22:35 -03:00
n8n.md Remove documentation files that have been merged into the mdbook 2025-11-30 18:07:22 -03:00
notion.md - SVG UI. 2025-12-01 02:22:35 -03:00
overview.md - SVG UI. 2025-12-01 02:22:35 -03:00
perplexity.md Remove documentation files that have been merged into the mdbook 2025-11-30 18:07:22 -03:00
README.md - SVG UI. 2025-12-01 02:22:35 -03:00
resources.md - SVG UI. 2025-12-01 02:22:35 -03:00
validation.md - SVG UI. 2025-12-01 02:22:35 -03:00
zapier-make.md Remove documentation files that have been merged into the mdbook 2025-11-30 18:07:22 -03:00

Chapter 14: Migration Guide

Migrate from cloud services to self-hosted General Bots with complete data sovereignty.

Why Migrate?

Cloud Services General Bots
Data on vendor servers Data on YOUR servers
$40-60/user/month ~$7/user/month
Vendor-controlled AI Transparent, traceable logic
Black box processing Extensible via BASIC
Subscription forever One-time deployment

Core Principles

Component Architecture

Install only what you need:

./botserver package install mail      # Email
./botserver package install drive     # Storage
./botserver package install directory # Users
./botserver package install meet      # Video

Standard Protocols

  • Storage: S3 API (MinIO)
  • Email: SMTP/IMAP/JMAP
  • Auth: OIDC/SAML/LDAP
  • Video: WebRTC

Knowledge Base Integration

USE KB "company_docs"
USE WEBSITE "https://sharepoint.company.com/docs"
' Documents now searchable via natural language

Migration Timeline

Phase Duration Activities
Assessment Week 1-2 Inventory services, identify dependencies
Infrastructure Week 2-3 Deploy BotServer, configure auth/storage
Data Migration Week 3-6 Users, email, files, documents
Process Migration Week 6-8 Convert workflows to .gbdialog
Validation Week 8-10 Testing, training, documentation
Cutover Week 10-12 User migration, decommission old

Migration Paths

Source Guide
Microsoft 365 M365 Migration
Google Workspace Google Migration
Dialogflow Dialogflow Migration
Botpress Botpress Migration
n8n / Zapier / Make Automation Migration
Notion Notion Migration

Prerequisites Checklist

  • Executive sponsorship
  • Infrastructure provisioned
  • Backup strategy defined
  • Rollback plan documented
  • User communication ready

Success Metrics

  • Performance: Response times, availability
  • Adoption: User login frequency
  • Cost: TCO reduction (target: 80%+)
  • Security: Compliance achievement

See Also