Skip to main content
If you’ve been using Vibe Kanban locally, you can migrate your existing projects to Cloud to unlock team collaboration, real-time sync, and access from any device.

​
Why Migrate?

Moving your projects to Cloud gives you:

Cloud Storage

Access your projects from anywhere. Your data syncs automatically across devices.

Team Collaboration

Invite teammates to your organisation and assign work to team members.

Comments

Add comments to issues to keep discussions in context with the work.

Sub-Issues

Break down complex work into smaller, manageable pieces.

GitHub Integration

Link pull requests directly to issues for seamless code tracking.

Tags & Priorities

Organise work with custom tags and priority levels.

​
Before You Start

Before migrating, make sure you have:
  1. A Cloud account - Sign in with GitHub or Google (a personal organisation is created automatically)
  2. Local projects - Projects stored on your machine that you want to migrate
Migration copies your data to Cloud - your local projects remain unchanged. You can continue using them locally if needed.

​
Starting the Migration

​
From the Project Banner

When viewing a local project that hasn’t been migrated, you’ll see a banner prompting you to migrate:
Migrate this project to the cloud banner with Learn more button
Click Learn more to open the migration wizard.

​
Migration Steps

The migration wizard guides you through four steps:

​
Step 1: Introduction

The first screen explains what Cloud offers and what will happen during migration.
Migration introduction screen showing Cloud benefits
  • If you’re not signed in, click Sign In to authenticate with GitHub or Google
  • If you’re already signed in, click Continue to proceed
When you click Sign In, you’ll see the authentication dialog:
Sign in dialog with GitHub and Google options

​
Step 2: Choose Projects

Select which local projects you want to migrate:
Choose projects screen showing project list and organisation selector
1

Review your projects

You’ll see a list of all your local projects with their names and IDs.
2

Select projects to migrate

Click the checkbox next to each project you want to migrate. Use Select All to choose everything at once.
Project selected for migration with Migrate button
Projects you’ve already migrated are shown separately with a View link to open them in Cloud.
3

Choose target organisation

If you have multiple organisations, select which one should receive the migrated projects.
4

Continue

Click Continue to proceed to the migration step.
You can migrate projects in batches. If you have many projects, consider migrating a few first to verify everything works as expected.

​
Step 3: Migrate

This step performs the actual migration:
  1. Click Start Migration to begin
  2. Wait while your data is transferred to Cloud
  3. You’ll see a summary report when complete
Migration summary showing projects and tasks migrated
ItemDescription
ProjectsHow many projects were migrated vs. total
TasksHow many issues/tasks were migrated
PR MergesHow many pull request links were migrated
WarningsAny issues encountered during migration
Don’t close the browser or navigate away while migration is in progress. This could result in incomplete data transfer.
Click Continue to proceed to the finish screen.

​
Step 4: Finish

The finish screen shows your migrated projects with quick access links:
Finish screen showing migrated projects with View links
  • Click View next to any project to open it in Cloud
  • Click Migrate More Projects to migrate additional projects

​
What Gets Migrated

The migration transfers the following data:

​
Projects

  • Project name
  • Project colour
  • All project settings

​
Issues (Tasks)

  • Issue titles and descriptions
  • Status (which column they’re in)
  • Any existing metadata
  • Connections between issues and GitHub PRs
  • PR status information

​
What Doesn’t Get Migrated

Some data is created fresh in Cloud:
  • Team members - You’ll need to invite teammates after migration
  • Comments - Local projects don’t have comments, so there’s nothing to migrate
  • Tags - You’ll set these up in your Cloud project
  • Priorities - Issues will need priorities assigned after migration

​
After Migration

When you return to your local project, you’ll see a banner indicating it’s been migrated to Cloud:
Project migrated to Cloud banner with View project button
Click View project to open the Cloud version with all collaboration features. Once your projects are in Cloud:

​
Invite Your Team

  1. Go to your organisation settings
  2. Invite team members via email
  3. They’ll receive an invitation to join

​
Set Up Your Board

  1. Open a migrated project
  2. Add tags for categorisation
  3. Set priorities on important issues
  4. Customise columns if needed

​
Connect GitHub (Optional)

If you want PR tracking:
  1. Go to organisation settings
  2. Install the GitHub App
  3. Enable code review for your repositories

​
Troubleshooting

Check your internet connection and try again. If the problem persists:
  1. Refresh the page
  2. Sign out and sign back in
  3. Try migrating fewer projects at once
If you continue to have issues, check the error message for specific details.
The migration report shows how many projects were skipped. Common reasons:
  • Duplicate names - A project with the same name already exists in the target organisation
  • Invalid data - The project has corrupted or incomplete data
Try renaming the local project and migrating again.
Check the following:
  1. Filters - Make sure you don’t have active filters hiding issues
  2. Columns - Check if issues are in a hidden status column
  3. Migration report - Review the report to see if tasks were skipped
If tasks were skipped, there may have been data issues. Check the warnings in the migration report.
You can run the migration wizard again and select a different target organisation. Note that this will create duplicate projects if you migrate the same projects twice.
Migration copies data to Cloud - it doesn’t delete your local projects. Your local data remains unchanged, so there’s nothing to “undo”.If you want to remove migrated projects from Cloud, you can delete them from the Cloud project list.