Move users and resumes from a self-hosted Reactive Resume v4 instance to the current version, by importing resumes one by one or with the migration scripts.
Reactive Resume v4 used a different database schema, so you can’t upgrade a v4 installation in place. Instead, you set up a new installation next to it and copy your users and resumes across. This page covers that move. To upgrade an existing v5 installation, see Migrating from v5 instead.
Keep your v4 instance running until every user and resume is in the new installation and you’ve checked the result.
It’s your fallback if something goes wrong. Work only on infrastructure and backups you’re authorized to operate.
Before you start
You need:
Your running v4 instance, and a recent backup of its PostgreSQL database.
Access to the v4 database (the source) and to a new, empty PostgreSQL database for the new installation (the target).
Scripts copy users, sign-in methods, resumes, and statistics straight from database to database.
Import resumes one by one
The current version reads v4 JSON exports directly and converts them.
1
Export from v4
In your v4 instance, open each resume and export it as JSON.
2
Import into the new installation
Sign in to the new installation (create an account first if needed), select Import on Documents, and choose the
JSON file. Reactive Resume recognizes the v4 format on its own. See Importing resumes
for details.
3
Check and repeat
Look through the imported resume, especially dates and layout, then repeat for the next one.
Run the migration scripts
The scripts live in the repository at tag v5.0.20, the last release that includes them. They were written against the database schema of that release, so you create the target database with that release first, run the scripts, and only then start the current version, which brings the data forward with its own migrations.
Don’t run the scripts against a database that a newer release has already set up. They don’t fill in columns added
later (such as the sign-in issuer added in v5.2.8), so migrated users could fail to sign in. Starting the current
version after the scripts fills those columns in.
Prepare the scripts
Install tsx and a .env loader such as dotenvx on the machine that runs the scripts, then check out the tag:
Use this checkout only to run the migration. Your actual installation runs the current release.Create a .env file at the root of the checkout:
.env
# The NEW, empty database (target)DATABASE_URL="postgresql://user:password@localhost:5432/reactive_resume"# The OLD v4 database (source)PRODUCTION_DATABASE_URL="postgresql://user:password@localhost:5432/reactive_resume_v4"
Double-check both connection strings. DATABASE_URL is the new target and PRODUCTION_DATABASE_URL is the old v4
source. Swapping them can destroy data. PRODUCTION_DATABASE_URL is used only by these scripts, never by the app.
Create the target schema
Apply the v5.0.20 migrations to the empty target database:
dotenvx run -- pnpm db:migrate
Migrate users
dotenvx run -- tsx scripts/migration/user.ts
The script:
Reads v4 users in batches and creates matching users in the target.
Copies sign-in methods (email and password, Google, GitHub, custom OAuth). Two-factor authentication isn’t copied: every migrated user starts with it turned off.
Writes scripts/migration/user-id-map.json, which links each v4 user ID to its new ID. The resume script needs it.
Saves progress to scripts/migration/user-progress.json after each batch. If the run stops, run it again to continue from the last saved batch.
It ends with a summary of users created, accounts created, and users skipped.
Migrated two-factor authentication is disabled. Before switching traffic, tell affected users to enable it again on
the new installation. Treat the transition as a change to account security.
Migrate resumes
dotenvx run -- tsx scripts/migration/resume.ts
The script:
Reads v4 resumes in batches, converts each to the new format, and assigns it to the right user through the ID map.
Copies view and download statistics, public or private visibility, and the locked state.
Saves progress to scripts/migration/resume-progress.json after each batch, and continues from there if you run it again.
It ends with a summary of resumes created, resumes skipped, and errors.
Each script deletes its progress file when it finishes. Keep user-id-map.json as the record of which v4 user became
which new user. Don’t re-run the scripts against a populated target to “fix” a problem; review the source backup, the
map, and the target first.
These historical scripts register cleanup on normal exit, not on SIGINT. Prefer letting a batch finish before
stopping it. After an interruption, retain the progress and ID-map files and verify the last batch before resuming.
Start the current version
Point a current Reactive Resume installation at the target database and start it. On startup it applies every migration since v5.0.20, which also fills in the new columns for the migrated users. Watch the logs for Database migrations completed.
After the migration
1
Check the data
Sign in as a few users and spot-check their resumes.
2
Test the essentials
Download a resume as PDF, and sign in with email and password and with each social provider you use.
3
Switch traffic
Point your DNS or reverse proxy at the new installation.
4
Retire v4
After a grace period with no problems, shut down the v4 instance.
What carries over
Passwords
People who signed up with email and password keep their password. No reset is needed.
Profile pictures and images
The database stores references to pictures, not the files. Give the new installation access to the same storage (for
example the same S3 bucket), or people re-upload their pictures.
Social and custom OAuth sign-in
Configure the same providers with the same client IDs in the new installation. Custom OAuth now uses a different
callback URL, so update your provider as described in Single sign-on (SSO). On the first
sign-in, the provider account is linked to the migrated user by email. For custom OAuth, that works only if the
user’s email was verified in v4; otherwise the sign-in stops with an “account not linked” error.
Two-factor authentication
Not carried over. Users who had two-factor authentication in v4 sign in with their password alone, and can set it up
again in Settings → Account.
Schema differences
v4’s visibility became a public/private flag, a resume’s title became its name, and resume data was
reorganized. The scripts and the importer handle these conversions.
Recover one person’s resumes later
Sometimes a person changes a resume in v4 after the main migration, or a resume didn’t come across. Handle this as a recovery case rather than re-running the scripts, and never overwrite the resume in the new installation.Keep a private record for each case, outside Git, because it links account and resume identifiers:
Case ID and the capture time of the source snapshot.
How you verified the person owns the account.
Source resume ID and mapped target resume ID, if there is one.
Source and target content hashes, and the outcome: no-op, export-copy, or blocked.
1
Confirm a source exists
Check that a source snapshot exists and note when it was taken. Records missing from every available source can’t be
reconstructed.
2
Verify ownership and mapping
Verify the requester through your approved account-ownership process, and confirm the old-to-new user mapping. A
matching email, resume title, or username alone isn’t proof. Stop if either check is incomplete.
3
Compare without writing
Identical content is a no-op. Content that exists only in the source, or differs, is an export-copy. Missing
evidence, mapping, valid data, or source is blocked. Content hashes prove equality only, never ownership or
authenticity.
4
Deliver a separate private export
Send the recovered JSON privately through an approved channel, so the person imports it as a new resume. Confirm the
delivered hash matches the source.
Troubleshooting
The script says PRODUCTION_DATABASE_URL is not set
Put both DATABASE_URL and PRODUCTION_DATABASE_URL in .env and run the scripts through dotenvx run -- (or
export the variables yourself).
Users are skipped
A user is skipped when their email or username already exists in the target, or when an earlier run already migrated
them. The console output gives the reason.
Resumes are skipped
A resume is skipped when its owner isn’t in the user ID map, when the owner already has a resume with the same slug,
or when an earlier run already migrated it.
A resume comes across empty
When a v4 resume can’t be parsed, the scripts can create empty default data. Treat that as a failed conversion, not
a recovered resume. Keep the source export and import it by hand once you’ve confirmed it’s valid.
Migrated users can't sign in
Check that you started the current version against the target database after the scripts, so its migrations ran. The
startup log shows Database migrations completed.
The migration is slow
The scripts work in batches to spare the databases. Run them off-peak, give both databases enough resources, or
adjust the batch size in the script files.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Reactive Resume","description":"A privacy-minded resume builder that is customizable, portable, open-source, and free to use.","colors":{"primary":"#166534","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/reactiveresume/lsEa0V8tmq-7Vofb/logo/light.svg?fit=max\u0026auto=format\u0026n=lsEa0V8tmq-7Vofb\u0026q=85\u0026s=21a2f3c9b27509effa871b216e67c0ce","dark":"https://mintcdn.com/reactiveresume/lsEa0V8tmq-7Vofb/logo/dark.svg?fit=max\u0026auto=format\u0026n=lsEa0V8tmq-7Vofb\u0026q=85\u0026s=fe4e07f4f06411b0ad16fd4644a475de","href":"https://rxresu.me"},"favicon":"https://mintcdn.com/reactiveresume/lsEa0V8tmq-7Vofb/favicon.svg?fit=max\u0026auto=format\u0026n=lsEa0V8tmq-7Vofb\u0026q=85\u0026s=6d7f6f71f71340846e94142b357a89b7","background":{"decoration":"grid"},"navbar":{"links":[{"href":"https://rxresu.me/resume-templates","label":"Resume templates"},{"href":"https://github.com/reactive-resume/reactive-resume/issues","label":"Support"}],"primary":{"type":"button","label":"Build your resume","href":"https://rxresu.me/auth/register"}},"footer":{"socials":{"website":"https://rxresu.me","github":"https://github.com/reactive-resume/reactive-resume"}},"seo":{"metatags":{"canonical":"https://docs.rxresu.me","og:image":"https://rxresu.me/opengraph/banner.jpg"},"indexing":"navigable"},"fonts":{"heading":{"family":"IBM Plex Sans"},"body":{"family":"IBM Plex Sans"}},"icons":{"library":"lucide"},"contextual":{"options":["copy","view"],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Reactive Resume","icon":"link","href":"https://rxresu.me"},{"anchor":"Source Code","icon":"github","href":"https://github.com/reactive-resume/reactive-resume"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"reactiveresume","hasAudioNarration":false,"actualSubdomain":"reactiveresume","customDomains":["docs.rxresu.me"],"gitSource":{"type":"github","owner":"reactive-resume","repo":"reactive-resume","deployBranch":"main","contentDirectory":"docs","isPrivate":false,"mountPath":"","label":""},"feedback":{"edits":true,"thumbs":false,"issues":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afe6da6be38cd8ab057294d","clientVersion":"0.0.4271","searchFilterCounts":[{"language":"default","tag":"API Reference","count":261},{"language":"default","tag":"Documentation","count":125},{"language":"default","tag":"Applications","count":56},{"language":"default","tag":"Career","count":45},{"language":"default","tag":"Documents","count":29},{"language":"default","tag":"Resumes","count":28},{"language":"default","tag":"Cover Letters","count":24},{"language":"default","tag":"Comparisons","count":17},{"language":"default","tag":"Agent","count":15},{"language":"default","tag":"Integrations","count":13}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"hello@amruthpillai.com","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[]}
{"page":{"pagePath":"self-hosting/migration","slug":"/self-hosting/migration","pageMetadata":{"title":"Migrating from v4","description":"Move users and resumes from a self-hosted Reactive Resume v4 instance to the current version, by importing resumes one by one or with the migration scripts.","href":"/self-hosting/migration"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Move users and resumes from a self-hosted Reactive Resume v4 instance to the current version, by importing resumes one by one or with the migration scripts.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,CodeBlock,Heading,Note,Step,Steps,Table,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Reactive Resume v4 used a different database schema, so you can’t upgrade a v4 installation in place. Instead, you set up a new installation next to it and copy your users and resumes across. This page covers that move. To upgrade an existing v5 installation, see `,_jsx(_components.a,{href:`/self-hosting/upgrading-to-v6`,children:`Migrating from v5`}),` instead.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Keep your v4 instance running until every user and resume is in the new installation and you’ve checked the result.\nIt’s your fallback if something goes wrong. Work only on infrastructure and backups you’re authorized to operate.`})}),`\n`,_jsx(Heading,{level:`2`,id:`before-you-start`,children:`Before you start`}),`\n`,_jsx(_components.p,{children:`You need:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Your running v4 instance, and a recent backup of its PostgreSQL database.`}),`\n`,_jsx(_components.li,{children:`Access to the v4 database (the source) and to a new, empty PostgreSQL database for the new installation (the target).`}),`\n`,_jsxs(_components.li,{children:[`A plan for the new installation. `,_jsx(_components.a,{href:`/self-hosting/docker`,children:`Self-hosting with Docker`}),` is the usual choice.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`choose-a-method`,children:`Choose a method`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Method`}),_jsx(_components.th,{children:`Best for`}),_jsx(_components.th,{children:`How it works`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.a,{href:`#import-resumes-one-by-one`,children:`Import resumes one by one`})}),_jsx(_components.td,{children:`A handful of resumes`}),_jsx(_components.td,{children:`Each person exports their v4 resumes as JSON and imports them into the new installation.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.a,{href:`#run-the-migration-scripts`,children:`Run the migration scripts`})}),_jsx(_components.td,{children:`Many users and resumes`}),_jsx(_components.td,{children:`Scripts copy users, sign-in methods, resumes, and statistics straight from database to database.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`import-resumes-one-by-one`,children:`Import resumes one by one`}),`\n`,_jsx(_components.p,{children:`The current version reads v4 JSON exports directly and converts them.`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Export from v4`,children:`In your v4 instance, open each resume and export it as JSON.`}),_jsx(Step,{title:`Import into the new installation`,children:_jsxs(_components.p,{children:[`Sign in to the new installation (create an account first if needed), select `,_jsx(_components.strong,{children:`Import`}),` on Documents, and choose the\nJSON file. Reactive Resume recognizes the v4 format on its own. See `,_jsx(_components.a,{href:`/guides/importing-resumes`,children:`Importing resumes`}),`\nfor details.`]})}),_jsx(Step,{title:`Check and repeat`,children:_jsx(_components.p,{children:`Look through the imported resume, especially dates and layout, then repeat for the next one.`})})]}),`\n`,_jsx(Heading,{level:`2`,id:`run-the-migration-scripts`,children:`Run the migration scripts`}),`\n`,_jsxs(_components.p,{children:[`The scripts live in the repository at tag `,_jsx(_components.code,{children:`v5.0.20`}),`, the last release that includes them. They were written against the database schema of that release, so you create the target database with that release first, run the scripts, and only then start the current version, which brings the data forward with its own migrations.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Don’t run the scripts against a database that a newer release has already set up. They don’t fill in columns added\nlater (such as the sign-in `,_jsx(_components.code,{children:`issuer`}),` added in v5.2.8), so migrated users could fail to sign in. Starting the current\nversion after the scripts fills those columns in.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`prepare-the-scripts`,children:`Prepare the scripts`}),`\n`,_jsxs(_components.p,{children:[`Install `,_jsx(_components.code,{children:`tsx`}),` and a `,_jsx(_components.code,{children:`.env`}),` loader such as `,_jsx(_components.code,{children:`dotenvx`}),` on the machine that runs the scripts, then check out the tag:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`npm`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` install`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -g`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` tsx`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` @dotenvx/dotenvx`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`git`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` clone`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --depth=1`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --branch`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` v5.0.20`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://github.com/reactive-resume/reactive-resume.git`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` reactive-resume-migration`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`cd`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` reactive-resume-migration`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`pnpm`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` install`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Use this checkout only to run the migration. Your actual installation runs the current release.`}),`\n`,_jsxs(_components.p,{children:[`Create a `,_jsx(_components.code,{children:`.env`}),` file at the root of the checkout:`]}),`\n`,_jsx(CodeBlock,{filename:`.env`,numberOfLines:`5`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# The NEW, empty database (target)`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`DATABASE_URL`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"postgresql://user:password@localhost:5432/reactive_resume\"`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# The OLD v4 database (source)`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`PRODUCTION_DATABASE_URL`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"postgresql://user:password@localhost:5432/reactive_resume_v4\"`})]}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Double-check both connection strings. `,_jsx(_components.code,{children:`DATABASE_URL`}),` is the new target and `,_jsx(_components.code,{children:`PRODUCTION_DATABASE_URL`}),` is the old v4\nsource. Swapping them can destroy data. `,_jsx(_components.code,{children:`PRODUCTION_DATABASE_URL`}),` is used only by these scripts, never by the app.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`create-the-target-schema`,children:`Create the target schema`}),`\n`,_jsxs(_components.p,{children:[`Apply the `,_jsx(_components.code,{children:`v5.0.20`}),` migrations to the empty target database:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`dotenvx`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` run`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` pnpm`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` db:migrate`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`migrate-users`,children:`Migrate users`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`dotenvx`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` run`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` tsx`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` scripts/migration/user.ts`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`The script:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Reads v4 users in batches and creates matching users in the target.`}),`\n`,_jsx(_components.li,{children:`Copies sign-in methods (email and password, Google, GitHub, custom OAuth). Two-factor authentication isn’t copied: every migrated user starts with it turned off.`}),`\n`,_jsxs(_components.li,{children:[`Writes `,_jsx(_components.code,{children:`scripts/migration/user-id-map.json`}),`, which links each v4 user ID to its new ID. The resume script needs it.`]}),`\n`,_jsxs(_components.li,{children:[`Saves progress to `,_jsx(_components.code,{children:`scripts/migration/user-progress.json`}),` after each batch. If the run stops, run it again to continue from the last saved batch.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`It ends with a summary of users created, accounts created, and users skipped.`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Migrated two-factor authentication is disabled. Before switching traffic, tell affected users to enable it again on\nthe new installation. Treat the transition as a change to account security.`})}),`\n`,_jsx(Heading,{level:`3`,id:`migrate-resumes`,children:`Migrate resumes`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`dotenvx`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` run`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` tsx`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` scripts/migration/resume.ts`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`The script:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Reads v4 resumes in batches, converts each to the new format, and assigns it to the right user through the ID map.`}),`\n`,_jsx(_components.li,{children:`Copies view and download statistics, public or private visibility, and the locked state.`}),`\n`,_jsxs(_components.li,{children:[`Saves progress to `,_jsx(_components.code,{children:`scripts/migration/resume-progress.json`}),` after each batch, and continues from there if you run it again.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`It ends with a summary of resumes created, resumes skipped, and errors.`}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Each script deletes its progress file when it finishes. Keep `,_jsx(_components.code,{children:`user-id-map.json`}),` as the record of which v4 user became\nwhich new user. Don’t re-run the scripts against a populated target to “fix” a problem; review the source backup, the\nmap, and the target first.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`These historical scripts register cleanup on normal exit, not on `,_jsx(_components.code,{children:`SIGINT`}),`. Prefer letting a batch finish before\nstopping it. After an interruption, retain the progress and ID-map files and verify the last batch before resuming.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`start-the-current-version`,children:`Start the current version`}),`\n`,_jsxs(_components.p,{children:[`Point a current Reactive Resume installation at the target database and start it. On startup it applies every migration since `,_jsx(_components.code,{children:`v5.0.20`}),`, which also fills in the new columns for the migrated users. Watch the logs for `,_jsx(_components.code,{children:`Database migrations completed`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`after-the-migration`,children:`After the migration`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Check the data`,children:`Sign in as a few users and spot-check their resumes.`}),_jsx(Step,{title:`Test the essentials`,children:_jsx(_components.p,{children:`Download a resume as PDF, and sign in with email and password and with each social provider you use.`})}),_jsx(Step,{title:`Switch traffic`,children:`Point your DNS or reverse proxy at the new installation.`}),_jsx(Step,{title:`Retire v4`,children:`After a grace period with no problems, shut down the v4 instance.`})]}),`\n`,_jsx(Heading,{level:`2`,id:`what-carries-over`,children:`What carries over`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Passwords`,id:`passwords`,children:_jsx(_components.p,{children:`People who signed up with email and password keep their password. No reset is needed.`})}),_jsx(Accordion,{title:`Profile pictures and images`,id:`profile-pictures-and-images`,children:_jsx(_components.p,{children:`The database stores references to pictures, not the files. Give the new installation access to the same storage (for\nexample the same S3 bucket), or people re-upload their pictures.`})}),_jsx(Accordion,{title:`Social and custom OAuth sign-in`,id:`social-and-custom-oauth-sign-in`,children:_jsxs(_components.p,{children:[`Configure the same providers with the same client IDs in the new installation. Custom OAuth now uses a different\ncallback URL, so update your provider as described in `,_jsx(_components.a,{href:`/self-hosting/sso`,children:`Single sign-on (SSO)`}),`. On the first\nsign-in, the provider account is linked to the migrated user by email. For custom OAuth, that works only if the\nuser’s email was verified in v4; otherwise the sign-in stops with an “account not linked” error.`]})}),_jsx(Accordion,{title:`Two-factor authentication`,id:`two-factor-authentication`,children:_jsxs(_components.p,{children:[`Not carried over. Users who had two-factor authentication in v4 sign in with their password alone, and can set it up\nagain in `,_jsx(_components.strong,{children:`Settings → Account`}),`.`]})}),_jsx(Accordion,{title:`Schema differences`,id:`schema-differences`,children:_jsxs(_components.p,{children:[`v4’s `,_jsx(_components.code,{children:`visibility`}),` became a public/private flag, a resume’s `,_jsx(_components.code,{children:`title`}),` became its `,_jsx(_components.code,{children:`name`}),`, and resume data was\nreorganized. The scripts and the importer handle these conversions.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`recover-one-person’s-resumes-later`,children:`Recover one person’s resumes later`}),`\n`,_jsx(_components.p,{children:`Sometimes a person changes a resume in v4 after the main migration, or a resume didn’t come across. Handle this as a recovery case rather than re-running the scripts, and never overwrite the resume in the new installation.`}),`\n`,_jsx(_components.p,{children:`Keep a private record for each case, outside Git, because it links account and resume identifiers:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Case ID and the capture time of the source snapshot.`}),`\n`,_jsx(_components.li,{children:`How you verified the person owns the account.`}),`\n`,_jsx(_components.li,{children:`Source resume ID and mapped target resume ID, if there is one.`}),`\n`,_jsxs(_components.li,{children:[`Source and target content hashes, and the outcome: `,_jsx(_components.code,{children:`no-op`}),`, `,_jsx(_components.code,{children:`export-copy`}),`, or `,_jsx(_components.code,{children:`blocked`}),`.`]}),`\n`]}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Confirm a source exists`,children:_jsx(_components.p,{children:`Check that a source snapshot exists and note when it was taken. Records missing from every available source can’t be\nreconstructed.`})}),_jsx(Step,{title:`Verify ownership and mapping`,children:_jsx(_components.p,{children:`Verify the requester through your approved account-ownership process, and confirm the old-to-new user mapping. A\nmatching email, resume title, or username alone isn’t proof. Stop if either check is incomplete.`})}),_jsx(Step,{title:`Compare without writing`,children:_jsxs(_components.p,{children:[`Identical content is a `,_jsx(_components.code,{children:`no-op`}),`. Content that exists only in the source, or differs, is an `,_jsx(_components.code,{children:`export-copy`}),`. Missing\nevidence, mapping, valid data, or source is `,_jsx(_components.code,{children:`blocked`}),`. Content hashes prove equality only, never ownership or\nauthenticity.`]})}),_jsx(Step,{title:`Deliver a separate private export`,children:_jsx(_components.p,{children:`Send the recovered JSON privately through an approved channel, so the person imports it as a new resume. Confirm the\ndelivered hash matches the source.`})})]}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`The script says PRODUCTION_DATABASE_URL is not set`,id:`the-script-says-production-database-url-is-not-set`,children:_jsxs(_components.p,{children:[`Put both `,_jsx(_components.code,{children:`DATABASE_URL`}),` and `,_jsx(_components.code,{children:`PRODUCTION_DATABASE_URL`}),` in `,_jsx(_components.code,{children:`.env`}),` and run the scripts through `,_jsx(_components.code,{children:`dotenvx run --`}),` (or\nexport the variables yourself).`]})}),_jsx(Accordion,{title:`Users are skipped`,id:`users-are-skipped`,children:_jsx(_components.p,{children:`A user is skipped when their email or username already exists in the target, or when an earlier run already migrated\nthem. The console output gives the reason.`})}),_jsx(Accordion,{title:`Resumes are skipped`,id:`resumes-are-skipped`,children:_jsx(_components.p,{children:`A resume is skipped when its owner isn’t in the user ID map, when the owner already has a resume with the same slug,\nor when an earlier run already migrated it.`})}),_jsx(Accordion,{title:`A resume comes across empty`,id:`a-resume-comes-across-empty`,children:_jsx(_components.p,{children:`When a v4 resume can’t be parsed, the scripts can create empty default data. Treat that as a failed conversion, not\na recovered resume. Keep the source export and import it by hand once you’ve confirmed it’s valid.`})}),_jsx(Accordion,{title:`Migrated users can't sign in`,id:`migrated-users-cant-sign-in`,children:_jsxs(_components.p,{children:[`Check that you started the current version against the target database after the scripts, so its migrations ran. The\nstartup log shows `,_jsx(_components.code,{children:`Database migrations completed`}),`.`]})}),_jsx(Accordion,{title:`The migration is slow`,id:`the-migration-is-slow`,children:_jsx(_components.p,{children:`The scripts work in batches to spare the databases. Run them off-peak, give both databases enough resources, or\nadjust the batch size in the script files.`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Migrating from v4","description":"Move users and resumes from a self-hosted Reactive Resume v4 instance to the current version, by importing resumes one by one or with the migration scripts.","href":"/self-hosting/migration"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Before you start","slug":"before-you-start","depth":2,"children":[]},{"title":"Choose a method","slug":"choose-a-method","depth":2,"children":[]},{"title":"Import resumes one by one","slug":"import-resumes-one-by-one","depth":2,"children":[]},{"title":"Run the migration scripts","slug":"run-the-migration-scripts","depth":2,"children":[{"title":"Prepare the scripts","slug":"prepare-the-scripts","depth":3,"children":[]},{"title":"Create the target schema","slug":"create-the-target-schema","depth":3,"children":[]},{"title":"Migrate users","slug":"migrate-users","depth":3,"children":[]},{"title":"Migrate resumes","slug":"migrate-resumes","depth":3,"children":[]},{"title":"Start the current version","slug":"start-the-current-version","depth":3,"children":[]}]},{"title":"After the migration","slug":"after-the-migration","depth":2,"children":[]},{"title":"What carries over","slug":"what-carries-over","depth":2,"children":[]},{"title":"Recover one person’s resumes later","slug":"recover-one-person’s-resumes-later","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"reactiveresume","siteName":"Reactive Resume","title":"Migrating from v4 - Reactive Resume","contextualStarterQuestions":[{"_id":"6af6f74c794db176cf3f09a0","deploymentId":"696550c78205dc150ed83107","questionText":"How do I migrate from v4?","status":"active","generatedBy":"contextual","path":"self-hosting/migration","createdAt":"2026-11-13T11:41:00.371Z","updatedAt":"2026-11-13T11:41:00.371Z","__v":0},{"_id":"6af6f74c794db176cf3f09a1","deploymentId":"696550c78205dc150ed83107","questionText":"Should I keep my v4 running?","status":"active","generatedBy":"contextual","path":"self-hosting/migration","createdAt":"2026-11-13T11:41:00.371Z","updatedAt":"2026-11-13T11:41:00.371Z","__v":0},{"_id":"6af6f74c794db176cf3f09a2","deploymentId":"696550c78205dc150ed83107","questionText":"What's the best migration method?","status":"active","generatedBy":"contextual","path":"self-hosting/migration","createdAt":"2026-11-13T11:41:00.371Z","updatedAt":"2026-11-13T11:41:00.371Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-13T11:40:52.882Z","originalFileLocation":"self-hosting/migration.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Move users and resumes from a self-hosted Reactive Resume v4 instance to the current version, by importing resumes one by one or with the migration scripts.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Reactive Resume\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/reactiveresume/m9TtW-C9R_eefHpI/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/reactiveresume/m9TtW-C9R_eefHpI/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/reactiveresume/m9TtW-C9R_eefHpI/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/reactiveresume/m9TtW-C9R_eefHpI/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/reactiveresume/m9TtW-C9R_eefHpI/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/reactiveresume/m9TtW-C9R_eefHpI/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/reactiveresume/m9TtW-C9R_eefHpI/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/reactiveresume/m9TtW-C9R_eefHpI/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/reactiveresume/m9TtW-C9R_eefHpI/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Migrating from v4 - Reactive Resume\">\u003cmeta data-mint-head property=\"og:description\" content=\"Move users and resumes from a self-hosted Reactive Resume v4 instance to the current version, by importing resumes one by one or with the migration scripts.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Reactive Resume\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.rxresu.me/self-hosting/migration\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://rxresu.me/opengraph/banner.jpg\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Migrating from v4 - Reactive Resume\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Move users and resumes from a self-hosted Reactive Resume v4 instance to the current version, by importing resumes one by one or with the migration scripts.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://rxresu.me/opengraph/banner.jpg\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/reactiveresume/m9TtW-C9R_eefHpI/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Reactive Resume\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#166534\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.rxresu.me/self-hosting/migration\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/self-hosting/migration.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.rxresu.me/#organization\",\"name\":\"Reactive Resume\",\"url\":\"https://docs.rxresu.me\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/reactiveresume/lsEa0V8tmq-7Vofb/logo/light.svg?fit=max\u0026auto=format\u0026n=lsEa0V8tmq-7Vofb\u0026q=85\u0026s=21a2f3c9b27509effa871b216e67c0ce\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.rxresu.me#website\",\"name\":\"Reactive Resume\",\"url\":\"https://docs.rxresu.me\",\"publisher\":{\"@id\":\"https://docs.rxresu.me/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.rxresu.me/self-hosting/migration#webpage\",\"url\":\"https://docs.rxresu.me/self-hosting/migration\",\"name\":\"Migrating from v4\",\"description\":\"Move users and resumes from a self-hosted Reactive Resume v4 instance to the current version, by importing resumes one by one or with the migration scripts.\",\"dateModified\":\"2026-11-13T11:40:52.882Z\",\"isPartOf\":{\"@id\":\"https://docs.rxresu.me#website\"},\"breadcrumb\":{\"@id\":\"https://docs.rxresu.me/self-hosting/migration#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.rxresu.me/self-hosting/migration#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Upgrade guides\",\"item\":\"https://docs.rxresu.me/self-hosting/upgrading-to-v6\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Migrating from v4\",\"item\":\"https://docs.rxresu.me/self-hosting/migration\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.rxresu.me/self-hosting/migration#article\",\"headline\":\"Migrating from v4\",\"name\":\"Migrating from v4\",\"description\":\"Move users and resumes from a self-hosted Reactive Resume v4 instance to the current version, by importing resumes one by one or with the migration scripts.\",\"url\":\"https://docs.rxresu.me/self-hosting/migration\",\"mainEntityOfPage\":{\"@id\":\"https://docs.rxresu.me/self-hosting/migration#webpage\"},\"image\":\"https://rxresu.me/opengraph/banner.jpg\",\"dateModified\":\"2026-11-13T11:40:52.882Z\",\"publisher\":{\"@id\":\"https://docs.rxresu.me/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.rxresu.me#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Reactive Resume\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Reactive Resume\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/self-hosting/migration.md","siteName":"Reactive Resume","nav":{"global":{"anchors":[{"anchor":"Reactive Resume","icon":"link","href":"https://rxresu.me"},{"anchor":"Source Code","icon":"github","href":"https://github.com/reactive-resume/reactive-resume"}]},"tabs":[{"tab":"Documentation","icon":"book","groups":[{"group":"Getting started","pages":[{"title":"Introduction","href":"/getting-started"},{"title":"Quickstart","href":"/getting-started/quickstart"},{"title":"Video guides","icon":"circle-play","href":"/guides/video-guides"},{"title":"What's new in v6","href":"/guides/whats-new-in-v6"},{"title":"Using the command bar","href":"/guides/using-the-command-bar"},{"title":"Keyboard shortcuts","href":"/guides/keyboard-shortcuts"},{"title":"Checking service status","href":"/guides/checking-service-status"},{"title":"Accessing the previous version","href":"/guides/accessing-the-previous-version"}]},{"group":"Account","pages":[{"title":"Creating an account","href":"/guides/creating-an-account"},{"title":"Signing in","href":"/guides/signing-in"},{"title":"Updating your account details","href":"/guides/updating-your-profile"},{"title":"Changing appearance and language","href":"/guides/changing-appearance-and-language"},{"title":"Linking social accounts","href":"/guides/linking-social-accounts"},{"title":"Setting up two-step verification","href":"/guides/setting-up-two-factor-authentication"},{"title":"Setting up passkeys","href":"/guides/setting-up-passkeys"},{"title":"Exporting your data","href":"/guides/exporting-your-data"},{"title":"Deleting your account","href":"/guides/deleting-your-account"}]},{"group":"Documents","pages":[{"title":"Creating your first resume","href":"/guides/creating-your-first-resume"},{"title":"Managing your documents","href":"/guides/managing-documents"},{"title":"Organizing documents with tags","href":"/guides/organizing-with-tags"},{"title":"Using the Trash","href":"/guides/using-the-trash"},{"title":"Importing a resume","href":"/guides/importing-resumes"}]},{"group":"Resume editor","pages":[{"title":"Getting to know the resume editor","href":"/guides/editor-overview"},{"title":"Filling in your details","href":"/guides/filling-in-your-details"},{"title":"Formatting text","href":"/guides/formatting-text"},{"title":"Managing sections","href":"/guides/managing-sections"},{"title":"Editing entries","href":"/guides/editing-entries"},{"title":"Entering dates","href":"/guides/entering-dates"},{"title":"Undoing changes and version history","href":"/guides/undoing-changes-and-version-history"},{"title":"Using private notes","href":"/guides/using-private-notes"},{"title":"Editing on a phone or tablet","href":"/guides/editing-on-mobile"}]},{"group":"Design","pages":[{"title":"Choosing a template","href":"/guides/choosing-a-template"},{"title":"Changing how entries look","href":"/guides/changing-how-entries-look"},{"title":"Customizing typography","href":"/guides/customizing-typography"},{"title":"Choosing colors","href":"/guides/choosing-colors"},{"title":"Choosing paper size, margins and language","href":"/guides/selecting-page-format"},{"title":"Arranging the layout","href":"/guides/arranging-the-layout"},{"title":"Fitting content on a page","href":"/guides/fitting-content-on-a-page"},{"title":"Applying custom styles","href":"/applying-custom-styles"}]},{"group":"Checking your resume","pages":[{"title":"Checking your resume before you apply","href":"/guides/checking-your-resume"},{"title":"Checking any resume PDF with the ATS checker","href":"/guides/using-the-ats-checker"}]},{"group":"Cover letters","pages":[{"title":"Writing a cover letter","href":"/guides/writing-a-cover-letter"}]},{"group":"Sharing and exporting","pages":[{"title":"Sharing your resume as a web page","href":"/guides/sharing-your-resume-publicly"},{"title":"Getting feedback on your resume","href":"/guides/getting-feedback-on-your-resume"},{"title":"Downloading your resume","href":"/guides/exporting-your-resume"},{"title":"Exporting a resume to Markdown","href":"/guides/exporting-resume-to-markdown"}]},{"group":"AI assistant","pages":[{"title":"Connecting an AI provider","href":"/guides/using-ai"},{"title":"Using the assistant","href":"/guides/using-the-assistant"},{"title":"Assistant tools","href":"/guides/ai-agent-tools"}]},{"group":"Career and application workspaces","pages":[{"title":"Your career, in one place","href":"/guides/career-overview"},{"title":"Prepare your first application","href":"/guides/first-career-application"},{"title":"Tell your story once","href":"/guides/building-career-knowledge"},{"title":"Apply when your experience is different","href":"/guides/checking-job-fit"},{"title":"Answer another application form","href":"/guides/writing-application-answers"},{"title":"Get ready for interview day","href":"/guides/preparing-for-interview-day"},{"title":"Find roles while you are busy","href":"/guides/finding-roles-automatically"},{"title":"Reply to a recruiter","href":"/guides/replying-to-recruiters"},{"title":"Choose between two offers","href":"/guides/comparing-job-offers"},{"title":"Career and workspace controls","href":"/guides/career-workspace-reference"}]},{"group":"Application tracker","pages":[{"title":"Tracking job applications","href":"/guides/tracking-job-applications"},{"title":"Adding an application","href":"/guides/adding-an-application"},{"title":"Managing an application","href":"/guides/managing-an-application"},{"title":"Customizing application stages","href":"/guides/customizing-application-stages"},{"title":"Scheduling interviews","href":"/guides/scheduling-interviews"},{"title":"Tailoring a resume for a job","href":"/guides/tailoring-a-resume-for-a-job"},{"title":"Viewing application insights","href":"/guides/viewing-application-insights"},{"title":"Importing applications from CSV","href":"/guides/importing-applications-from-csv"}]},{"group":"Integrations","pages":[{"title":"Using the API","href":"/guides/using-the-api"},{"title":"Using the patch API","href":"/guides/using-the-patch-api"},{"title":"Reactive Resume JSON schema","href":"/guides/json-resume-schema"},{"title":"Using the MCP server","href":"/guides/using-the-mcp-server"},{"title":"Using WebMCP","href":"/guides/using-webmcp"},{"title":"Managing applications with MCP","href":"/guides/managing-applications-with-mcp"},{"title":"Using agent skills","href":"/guides/using-agent-skills"},{"title":"Large RPC requests","href":"/guides/large-rpc-requests"}]},{"group":"Use cases","pages":[{"title":"Free resume builder","href":"/use-cases/free-resume-builder"},{"title":"Open-source resume builder","href":"/use-cases/open-source-resume-builder"},{"title":"Privacy-focused resume builder","href":"/use-cases/privacy-focused-resume-builder"},{"title":"Self-hosted resume builder","href":"/use-cases/self-hosted-resume-builder"},{"title":"API and MCP resume automation","href":"/use-cases/api-mcp-resume-automation"},{"title":"Export and share resumes","href":"/use-cases/export-and-share-resumes"},{"title":"AI resume builder","href":"/use-cases/ai-resume-builder"}]},{"group":"Comparisons","pages":[{"title":"Reactive Resume vs Canva","href":"/comparisons/reactive-resume-vs-canva"},{"title":"Reactive Resume vs Adobe Express","href":"/comparisons/reactive-resume-vs-adobe-express"},{"title":"Reactive Resume vs Overleaf","href":"/comparisons/reactive-resume-vs-overleaf"},{"title":"Reactive Resume vs Resume.com","href":"/comparisons/reactive-resume-vs-resume-com"},{"title":"Reactive Resume vs MyPerfectResume","href":"/comparisons/reactive-resume-vs-myperfectresume"},{"title":"Reactive Resume vs Resume-Now","href":"/comparisons/reactive-resume-vs-resume-now"},{"title":"Reactive Resume vs Resume.io","href":"/comparisons/reactive-resume-vs-resume-io"},{"title":"Reactive Resume vs Zety","href":"/comparisons/reactive-resume-vs-zety"},{"title":"Reactive Resume vs Kickresume","href":"/comparisons/reactive-resume-vs-kickresume"},{"title":"Reactive Resume vs ResumeGemini","href":"/comparisons/reactive-resume-vs-resumegemini"},{"title":"Reactive Resume vs Jobscan","href":"/comparisons/reactive-resume-vs-jobscan"},{"title":"Reactive Resume vs Resumod","href":"/comparisons/reactive-resume-vs-resumod"},{"title":"Reactive Resume vs Rezi","href":"/comparisons/reactive-resume-vs-rezi"},{"title":"Reactive Resume vs CareerCircle","href":"/comparisons/reactive-resume-vs-careercircle"},{"title":"Reactive Resume vs Novorésumé","href":"/comparisons/reactive-resume-vs-novoresume"},{"title":"Reactive Resume vs LiveCareer","href":"/comparisons/reactive-resume-vs-livecareer"},{"title":"Reactive Resume vs Freesumes","href":"/comparisons/reactive-resume-vs-freesumes"}]},{"group":"Self-hosting","pages":[{"title":"Self-hosting with Docker","href":"/self-hosting/docker"},{"title":"Self-hosting with Kubernetes","href":"/self-hosting/kubernetes"},{"title":"Self-hosting on Vercel","href":"/self-hosting/vercel"},{"title":"Self-hosting on Hostinger","href":"/self-hosting/hostinger"},{"title":"Self-hosting on Cloudflare","href":"/self-hosting/cloudflare"},{"title":"Self-hosting on your NAS","href":"/self-hosting/nas"}]},{"group":"Server configuration","pages":[{"title":"Environment variables","href":"/self-hosting/environment-variables"},{"title":"Sharing domains","href":"/self-hosting/sharing-domains"},{"title":"Self-host resume fonts","href":"/self-hosting/fonts"},{"title":"Deployment examples","href":"/self-hosting/examples"},{"title":"Job search and AI","href":"/self-hosting/job-search-and-ai"},{"title":"Single sign-on (SSO)","href":"/self-hosting/sso"}]},{"group":"Upgrade guides","pages":[{"title":"Migrating from v5","description":"Upgrade a self-hosted Reactive Resume v5 installation to v6: back up, run the startup migrations, convert old styles, and check API and MCP changes.","href":"/self-hosting/upgrading-to-v6"},{"title":"Migrating from v4","href":"/self-hosting/migration"}]},{"group":"Contributing","pages":[{"title":"Development setup","description":"Run Reactive Resume locally with Node.js 26, pnpm, and Docker, then use the everyday commands for the database, tests, linting, and pull requests.","href":"/contributing/development"},{"title":"Project architecture","href":"/contributing/architecture"},{"title":"Web access adapters","href":"/contributing/web-access"},{"title":"Career platform rollout","href":"/contributing/career-platform"},{"title":"Contributing translations","href":"/contributing/translations"},{"title":"Deployment checks","href":"/contributing/deployment-checks"},{"title":"Storage cleanup jobs","href":"/contributing/storage-cleanup"}]},{"group":"Community","pages":[{"title":"Sponsors","href":"/community/sponsors"},{"title":"Spotlight","href":"/community/spotlight"}]},{"group":"Legal","pages":[{"title":"License","href":"/legal/license"},{"title":"Privacy Policy","href":"/legal/privacy-policy"},{"title":"Terms of Service","href":"/legal/terms-of-service"}]}]},{"tab":"Changelog","icon":"clock","pages":[{"title":"Changelog","href":"/changelog"}]},{"tab":"API Reference","icon":"code","pages":[{"title":"API Reference","href":"/api-reference/system/get-application-health-and-version"}]}]},"basePath":"","title":"Migrating from v4 - Reactive Resume","deploymentId":"dpl_Em2U4NQQ2N2DE3HPbPUJVZLnAtvc","buildId":"dpl_Em2U4NQQ2N2DE3HPbPUJVZLnAtvc","dynamics":[],"chunks":[]}