Skip to content

Talk to us about moving from CoderHelm cloud to self-host - #225

Merged
nambok merged 1 commit into
mainfrom
feat/migrate-to-selfhost-contact
Oct 26, 2026
Merged

nambok merged 1 commit into
mainfrom
feat/migrate-to-selfhost-contact

Conversation

@nambok

@nambok nambok commented Oct 26, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

Adds a "we'll help you move" contact path everywhere people consider self-hosting. The marketing site has no contact form, so the path is an email to support@coderhelm.com with the subject "Moving to self-hosted CoderHelm". In the hosted dashboard, it is the existing Contact us ticket flow with the move preset. A person helps with the move. There is no export or import of team data between hosted and self-host, so nothing here promises an automatic migration.

Paired with CoderHelm/coderhelm-platform#308 (the self-host overview page in the docs).

Changes

  • coderhelm.com (src/content/site.ts): SITE.moveUrl. /self-host/ gets a "Moving from CoderHelm cloud?" section with a Talk to us about moving button. The home page's self-host section gets a short line with the same link. The Markdown twins carry both.
  • Install guide (docs/components/install/wizard.tsx, docs/lib/shared.ts): "Moving from CoderHelm cloud? Talk to us and we'll help move your data." It shows under the summary panel on the first screen and on the Ready screen.
  • Dashboard, hosted only:
    • settings/page.tsx: a Move to your own AWS account card under "Hosting" on the Settings hub. It is never rendered when isSelfHosted().
    • support/page.tsx: type=selfhost opens Contact us titled "Move to your own AWS account", with the subject preset to "Move to self-host". It adds a short form for team size, AWS region and what to bring over (checkboxes). Notes are optional. The answers become the ticket body, and the ticket is filed through the normal POST /api/support/tickets, so it is routed like any other contact ticket. On a self-hosted install, type=selfhost falls back to plain Get help.
  • There is no ticket topic list in platform code, so the topic travels in the subject.

Verification

  • Site: npm run lint (no errors in source; the only errors are in a local dashboard/.next build output, same as main) and npm run build pass. Checked the built HTML and Markdown for the mailto link. No sideways scroll at 1440 or 390.
  • Docs: test:unit (69 pass), typecheck, build, check:output, check:links and the full e2e suite (77 pass) pass. New e2e assertions check the line and link on the Ready screen and in the summary panel.
  • Dashboard: tsc --noEmit and the UI lint pass. New e2e tests in support.spec.ts:
    • At 1440 and at 390, the card files a "Move to self-host" ticket with exactly the answers. The tests also check that there is no sideways scroll.
    • On a self-hosted install, the card is hidden and the move link is plain help.
    • Together with markdown-editor.spec.ts, 21 tests pass.
  • Screenshots reviewed: the Settings card, the form at both widths, the site sections and the install guide screens.

- coderhelm.com /self-host/: a "Moving from CoderHelm cloud?" section with
  a Talk to us about moving button, and a short line in the home page's
  self-host section. The site has no contact form, so the button is an
  email to support@ with the subject "Moving to self-hosted CoderHelm".
- Install guide: the same line under the summary on the first screen and
  on the Ready screen.
- Dashboard (hosted only): a Move to your own AWS account card in
  Settings. It opens Contact us with the move preset: team size, AWS
  region and what to bring over, filed as a normal support ticket whose
  subject is "Move to self-host". Never shown on a self-hosted install.

A person helps with the move; nothing is copied automatically.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant