Migrating from Heroku to the Qoddi App Platform is very easy and requires a small amount of time. This guide will guide you in the process of moving your app from Heroku to Qoddi, including databases, Redis, and Docker containers.
Some add-ons are not (yet) available on Qoddi, like the Sparkpost email sending library, and may need to be included in your code using the language library. We do our best to onboard third-party add-ons on Qoddi as quickly as possible.
Qoddi works seamlessly with GitHub and supports most Heroku build packs. The main difference between Qoddi and Heroku is that Qoddi doesn’t require any configuration file or CLI to use, everything is managed from the Qoddi dashboard.
Pre-requisites
- Create a free account at https://qoddi.com
- Add a valid credit card to your account
Migration Steps
- Understanding the difference between Qoddi and Heroku infrastructures
- Create your app on Qoddi
- Configure Environment variables
- Install Adminer to import data to PostgreSQL and import data
- Update DNS configuration
- Troubleshoot the build process
Understanding the differences between Qoddi and Heroku infrastructures
The way Qoddi and Heroku host your apps and route data inside the network is fairly different.
Here’s what you need to be aware of before starting:
- Qoddi’s infrastructure uses a modern, serverless implementation. Only web data can reach your apps, no matter the port used. Pay attention to the port your app uses to be reachable from the Internet and use the same port inside your app settings on Qoddi (that can be 80,8080, 3306, or whatever port your choose to use).
- Qoddi’s internal network always routes the traffic depending on what your app needs. For instance, it will never route web queries to a database, and all the internal traffic is encrypted.
- Datastores created on Qoddi cannot be reached from the Internet, meaning you can’t connect to your PostgreSQL database on Qoddi from an app hosted elsewhere; this is by design and applicable to all datastores (including Redis).
Create your App on Qoddi
From the Qoddi dashboard click +, choose the size and location of your app, and connect your GitHub repository. You can also select a datastore (Postgres if coming from Heroku) directly during the app creation phase, your app will have all the parameters to connect to the database automatically set up.
Configure Environment Variables
It’s critical to keep all sensitive information inside the Environment Variables instead of your code (like database passwords or third-party keys). Qoddi doesn’t support .env files and requires that all environment variables be created from the Qoddi Dashboard.
Install Adminer add-on for Postgres and Import Data
Adminer is a free app available on Qoddi’s Marketplace to manage your PostgreSQL database. Click “Marketplace” from the Qoddi dashboard and launch Adminer inside the same stack of your database (if the database is created)
Adminer is created as a Web App inside the same stack and can be accessed using Qoddi’s URL.
To connect to your Postgres database, check the internal name, username, and password from the database settings page:
Use the same value to connect to your database using Adminer:
And voila! From Adminer you can import your . SQL file from Heroku.
Note: You can use Adminer to connect to your Heroku PostgreSQL app directly from Qoddi to export your SQL file.
Update DNS configuration
Note: this feature is not available for Free apps
Add your domain name to your Qoddi app :
Copy the CNAME record and create a CNAME from your DNS provider (here’s a detailed procedure) :
Troubleshoot the build process
Visit the Deploy tab of your app to see the last deployment and access the build log. This will give you a detailed view of the build process and, if the build failed, the exact reason.
The log tab can also be helpful if your app doesn’t start. Most of cases, it’s because the app port used by your code is different than the one set up by default on Qoddi; adjusting the app port will fix this issue.
If you have any issues, don’t delete your app yet! Most of cases, it’s an easy fix; contact us!
Also Published here