botbook/src/14-migration
2025-12-12 23:18:36 -03:00
..
automation.md Update: General project updates 2025-12-06 11:09:12 -03:00
botpress.md Update: General project updates 2025-12-06 11:09:12 -03:00
common-concepts.md Update: General project updates 2025-12-06 11:09:12 -03:00
comparison-matrix.md Update: General project updates 2025-12-06 11:09:12 -03:00
dialogflow.md Update: General project updates 2025-12-06 11:09:12 -03:00
google-workspace.md Update: General project updates 2025-12-06 11:09:12 -03:00
intercom.md Update: General project updates 2025-12-06 11:09:12 -03:00
kb-migration.md Update: General project updates 2025-12-06 11:09:12 -03:00
microsoft-365.md Update: General project updates 2025-12-06 11:09:12 -03:00
n8n.md Update: General project updates 2025-12-06 11:09:12 -03:00
notion.md Update: General project updates 2025-12-06 11:09:12 -03:00
overview.md Update: General project updates 2025-12-06 11:09:12 -03:00
perplexity.md Update: General project updates 2025-12-06 11:09:12 -03:00
README.md Lowercase botserver/botbook references, add bottemplates repo, update autonomous tasks docs 2025-12-12 23:18:36 -03:00
resources.md Update: General project updates 2025-12-06 11:09:12 -03:00
validation.md Update: General project updates 2025-12-06 11:09:12 -03:00
zapier-make.md Update: General project updates 2025-12-06 11:09:12 -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