For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /start/migration.md.

Migration Guide

Migration tool

Migrate configuration files from nacos to confkeeper.

The migration mainly covers the configuration file table and namespace table.

Start confkeeper once first so that all tables are created.

Then run the migration tool with a config file:

./confkeeper-migrate --config=config.yaml

Example config:

Tip

The tenant_names option specifies which namespaces to migrate. If this option is omitted, all namespaces will be migrated.

# Database configuration
source:
  type: "mysql"
  mysql:
    host: "localhost"
    port: 3306
    username: "nacos"
    password: "xxx"
    database: "nacos_devtest"
    charset: "utf8mb4"

target:
  type: "postgresql"
  postgresql:
    host: "localhost"
    port: 5432
    username: "postgres"
    password: "xxx"
    database: "confkeeper"
    sslmode: "disable"

# Migration configuration
migration:
  batch_size: 1000
  timeout_seconds: 300
  tenant_names:
    - "default"