{"id":21371517,"url":"https://github.com/chirpstack/chirpstack-v3-to-v4","last_synced_at":"2025-07-13T07:31:30.337Z","repository":{"id":41650041,"uuid":"482861773","full_name":"chirpstack/chirpstack-v3-to-v4","owner":"chirpstack","description":"Utility to migate ChirpStack v3 data into ChirpStack v4.","archived":false,"fork":false,"pushed_at":"2024-12-11T09:56:16.000Z","size":132,"stargazers_count":8,"open_issues_count":2,"forks_count":6,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-07T07:26:28.381Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chirpstack.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"chirpstack"}},"created_at":"2022-04-18T13:43:26.000Z","updated_at":"2024-12-11T09:56:18.000Z","dependencies_parsed_at":"2023-12-18T16:03:40.183Z","dependency_job_id":"0a5ae995-ba2f-45c9-b2b7-78e8747e328e","html_url":"https://github.com/chirpstack/chirpstack-v3-to-v4","commit_stats":{"total_commits":37,"total_committers":2,"mean_commits":18.5,"dds":"0.027027027027026973","last_synced_commit":"81916983ac211ba6fec2a69dc5067edfb61fd88e"},"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/chirpstack/chirpstack-v3-to-v4","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chirpstack%2Fchirpstack-v3-to-v4","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chirpstack%2Fchirpstack-v3-to-v4/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chirpstack%2Fchirpstack-v3-to-v4/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chirpstack%2Fchirpstack-v3-to-v4/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chirpstack","download_url":"https://codeload.github.com/chirpstack/chirpstack-v3-to-v4/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chirpstack%2Fchirpstack-v3-to-v4/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265105508,"owners_count":23712153,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-22T08:13:46.476Z","updated_at":"2025-07-13T07:31:30.332Z","avatar_url":"https://github.com/chirpstack.png","language":"Go","funding_links":["https://github.com/sponsors/chirpstack"],"categories":[],"sub_categories":[],"readme":"# ChirpStack v3 to v4 data-migration\n\nThis utility migrates data from a single ChirpStack Application Server instance\nand one or multiple ChirpStack Network Server instances (in case of multiple-regions)\ninto the new ChirpStack v4 data-structure.\n\nHelp:\n\n```\nUsage:\n  chirpstack-v3-to-v4 [flags]\n\nFlags:\n      --as-config-file string                Path to chirpstack-application-server.toml configuration file\n      --cs-config-file string                Path to chirpstack.toml configuration file\n      --deveui-list-file string              Path to file containing DevEUIs to migrate (one DevEUI per line)\n      --device-profile-id-list-file string   Path to file containing list of Device Profile IDs to migrate (one per line)\n      --device-session-ttl-days int          Device-session TTL in days (default 31)\n      --disable-migrated-devices             Disable migrated devices in ChirpStack v3\n      --drop-tenants-and-users               Drop tenants and users before migration\n  -h, --help                                 help for chirpstack-v3-to-v4\n      --migrate-applications                 Migrate applications (default true)\n      --migrate-device-metrics               Migrate device metrics (default true)\n      --migrate-device-profiles              Migrate device profiles (default true)\n      --migrate-devices                      Migrate devices (default true)\n      --migrate-gateway-metrics              Migrate gateway metrics (default true)\n      --migrate-gateways                     Migrate gateways (default true)\n      --migrate-tenants                      Migrate tenants (default true)\n      --migrate-users                        Migrate users (default true)\n      --ns-config-file stringArray           Path to chirpstack-network-server.toml configuration file (can be repeated)\n```\n\nUsage example:\n\n```\n./chirpstack-v3-to-v4 \\\n\t--cs-config-file /etc/chirpstack/chirpstack.toml \\\n\t--as-config-file /etc/chirpstack-application-server/chirpstack-application-server.toml \\\n\t--ns-config-file /etc/chirpstack-network-server/chirpstack-network-server.toml\n```\n\n**Warning:** Always make a backup before starting a migration. If the\n`--drop-tenants-and-users` argument is used, then all data in the target\ndatabase will be removed!\n\n## Notes\n\n* This utility is compatible with the ChirpStack v4.11.x database schema. It\n  is **not** compatible with ChirpStack v4.12+. Users should migrate from v3\n\tto the latest v4.11.x version, and after the migration upgrade to the latest\n\tChirpStack v4 version.\n* This utility does not support [environment variables](https://www.chirpstack.io/docs/chirpstack/configuration.html#environment-variables) in configuration files, like ChirpStack does.\n\n## Building from source\n\nFor creating a snapshot release:\n\n```\nmake snapshot\n```\n\nFor creating a release:\n\n```\nmake release\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchirpstack%2Fchirpstack-v3-to-v4","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchirpstack%2Fchirpstack-v3-to-v4","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchirpstack%2Fchirpstack-v3-to-v4/lists"}