How to Migrate from Kanboard to a Modern UI with FrankBoard
How to Migrate from Kanboard to a Modern UI with FrankBoard
Transition your existing project data from a legacy Kanboard installation to the streamlined FrankBoard interface. This process ensures your tasks and workflows remain intact while upgrading your team's user experience.
What You'll Need
- Existing Kanboard installation
- Docker and Docker Compose installed on your VPS or local server
- Administrative access to the Kanboard database
- FrankBoard Docker image
Steps
Step 1: Backup Existing Data
Create a full backup of your current Kanboard database and any attached files. This ensures you have a recovery point before modifying your environment or migrating data.
Step 2: Prepare the Docker Environment
Configure your docker-compose.yml file to include the FrankBoard image. Ensure you have defined the necessary volume mappings to persist your project data across container restarts.
Step 3: Align Database Compatibility
Verify that your database version is compatible with the FrankBoard requirements. Since FrankBoard is built on the Kanboard core, it maintains high compatibility with existing schemas.
Step 4: Deploy FrankBoard via Docker
Run the docker-compose up command to launch the FrankBoard container. This initializes the polished UI layer over the functional Kanban engine.
Step 5: Connect Existing Data
Point the FrankBoard installation to your existing Kanboard database. Update the environment variables in your Docker configuration to match your database credentials and host.
Step 6: Verify Data Integrity
Log in to the new interface and verify that all projects, tasks, and columns have migrated correctly. Check that task descriptions and attachments are rendering properly in the modern UI.
Step 7: Optimize User Permissions
Review your user roles and access levels within the new interface. Ensure that team members have the correct permissions to maintain a seamless workflow transition.
Step 8: Decommission Legacy Instance
Once you have confirmed the stability of the FrankBoard deployment, stop and remove the old Kanboard container. Keep your initial backup stored securely for a designated grace period.
Expert Tips
- Use a reverse proxy like Nginx or Traefik to handle SSL termination for a professional, secure deployment.
- Perform a test migration on a staging server before updating your production environment.
- Keep your Docker images updated to benefit from the latest UI refinements and security patches.
- Audit your custom plugins before migrating, as some legacy extensions may conflict with the modern interface.