What does the Migrator 3000 app do?
The Migrator app enables you to move events from one PostHog instance to another, so that you can move from a self-hosted instance to a PostHog Cloud deployment, or vice versa.
Does the Migrator 3000 app move all content to the new instance?
No, this app will only migrate events and objects derived from events, such as persons. Dashboards, Insights, Feature Flags, etc. will not be migrated and must be manually recreated on the new instance.
What are the requirements for this app?
The Migrator 3000 app requires *two** PostHog Cloud, or a self-hosted PostHog instances running version 1.30.0 or later.
Not running 1.30.0? Find out how to update your self-hosted PostHog deployment!
How do I install the Migrator 3000 app for PostHog Cloud?
This app is already installed as default for PostHog Cloud users. Simply click 'Apps' on the left-hand tool bar, find the Migrator 3000 app and enable it to get started.
How do I install the Migrator 3000 app on a self-hosted deployment?
- Log in to your PostHog instance
- Click 'Apps' on the left-hand tool bar
- Search for 'Migrator 3000' press 'Install'
- Configure the by app by following the instructions below.
How do I configure the Migrator 3000 app?
To configure the app, follow the configuration steps once the app is enabled and enter the following information.
Host - This is the host of your PostHog instance (without http or https). Set this to
app.posthog.comif you are migrating to PostHog Cloud.Project API Key - This is the project API key (token) of the instance you wish to migrate to.
Date to start exporting from - How much historic data do you want to export? Use the format YYYY-MM-DD.
PostHog version - Self-hosted users can find their PostHog version from /instance/status
Configuration
| Option | Description |
|---|---|
HostType: string Required: True | E.g. posthog.yourcompany.com |
Project API KeyType: string Required: True | Grab it from e.g. https://posthog.yourcompany.com/project/settings |
Date to start exporting events fromType: string Required: False | Use format YYYY-MM-DD e.g. 2021-10-26 = 26th October 2021. Not specifying a value will export all events. |
DEBUGType: choice Required: False | Turn this on to get additional logging from the plugin |
PostHog versionType: choice Required: False | The PostHog version this instance is on. Format: x.y.z. Select 'Latest' when using this in PostHog Cloud. |
Were there 2999 earlier versions of this app?
No, it's just a cool name. A very cool name.
Is the source code for this app available?
PostHog is open-source and so are all apps on the platform. The source code for the Migrator 3000 is available on GitHub.
Who created this app?
We'd like to thank PostHog team members Yakko Majuri, Tim Glaser, James Hawkins and Marius Andra for creating the Migrator 3000.
Nobody has yet stepped forward to take credit for the name, however.
Who maintains this app?
This app is maintained by PostHog. If you have issues with the app not functioning as intended, please raise a bug report to let us know!
What if I have feedback on this app?
We love feature requests and feedback! Please create an issue to tell us what you think.
What if my question isn't answered above?
We love answering questions. Ask us anything via our Support page.
You can also join the PostHog Community Slack group to collaborate with others and get advice on developing your own PostHog apps.