Migrating to a Direct Account

Note

These instructions are tailored to Heroku users, but the information also holds true for Manifold users.

Migrating from a Heroku Account to a Direct Account requires minor configuration changes in the Heroku application. This will require redeployment of the application.

How It Works:

  1. Sign up for an account at Bonsai.io. Please make sure to add your billing information.
  2. Change your application to use ELASTICSEARCH_URL environment variable rather than BONSAI_URL.
  3. Then configure your application in Heroku with the new ELASTICSEARCH_URL shown below:
    heroku config:set ELASTICSEARCH_URL=$(heroku config:get BONSAI_URL)
    When you uninstall the Bonsai add-on, Heroku will remove the BONSAI_URL configuration setting. By redeploying your application to use this different environment variable now, you can remove any downtime for your application in later steps.
  4. Email support@bonsai.io and include: A) the email address associated with your new Bonsai account and B) the cluster(s) that you want migrated over.
  5. We’ll perform the migration. Your cluster URLs and all your data will remain intact. You will be billed at the monthly rate once that migration is complete. We’ll let you know once this step is done.
  6. Once we have confirmed that the migration is complete, remove the Bonsai addon(s) from your Heroku app so you’re not being billed twice! Uninstalling the Bonsai add-on at this step in Elasticsearch will remove the BONSAI_URL.
  7. You can migrate the rest of your application at your convenience. Any cluster we have migrated will now belong to your Bonsai.io account and can be managed there. Please let us know if your application is not functioning as expected.

That’s it! Migrations are zero-downtime and take only a few minutes once our support team takes the ticket.