How to Migrate from Kanboard to FrankBoard
How to Migrate from Kanboard to FrankBoard
Upgrade your project management experience by transitioning your legacy Kanboard data to the modern, polished interface of FrankBoard. This process ensures you retain your existing workflows while eliminating the dated UI.
What You'll Need
- Existing Kanboard installation
- Docker and Docker Compose installed on your VPS
- Administrative access to both systems
- A recent backup of your Kanboard database
Steps
Step 1: Backup Legacy Data
Create a full snapshot of your current Kanboard database and upload directory. This ensures that you have a recovery point before initiating any data transfers or configuration changes.
Step 2: Deploy FrankBoard via Docker
Pull the official FrankBoard image and configure your docker-compose.yml file. Start the container to initialize the environment and ensure the web interface is accessible on your network.
Step 3: Configure Database Connectivity
Point your FrankBoard installation to your existing database or prepare the import script. Ensure the environment variables for database credentials match your current setup to allow seamless data reading.
Step 4: Execute the Data Migration
Run the migration utility to map Kanboard's data structures to the FrankBoard schema. This process transfers your boards, tasks, and user permissions while upgrading the visual presentation.
Step 5: Verify Task Integrity
Audit a sample of your migrated boards to ensure that task descriptions, labels, and attachments transferred correctly. Check that the Kanban flow remains intact and that no data was truncated during the move.
Step 6: Update User Access
Invite your team members to the new interface and verify their permission levels. Since FrankBoard maintains a developer-centric approach, ensure that administrative roles are correctly assigned.
Step 7: Decommission Old Instance
Once the team has confirmed the stability of the new board, stop the legacy Kanboard container. Archive the old database as a read-only backup before removing the instance from your VPS.
Expert Tips
- Perform a test migration on a staging environment before updating your production board.
- Clean up unused tasks and archived boards in Kanboard first to speed up the migration process.
- Use a reverse proxy like Nginx Proxy Manager to handle SSL termination for your new Docker deployment.
- Double-check file permissions on your mapped Docker volumes to avoid attachment upload errors.