Migration guide

Migrate from Fern to Octri

Zip the repository that holds your fern folder and upload it. Your SDK languages, package name, spec, accent colour, logo and favicon come across, and every page in docs.yml is listed with its path.

Written by Octri · Checked 25 October 2026

What to have to hand

Octri reads Fern’s own files. A .zip of your repository or a single config file, up to 15 MB.

  • fern/generators.yml
  • fern/docs.yml
  • fern/fern.config.json
  • openapi.yml

What comes across

Each row is a field the Fern importer reads, and where it lands. Rows marked “By hand” are what is left for you.

WhatIn OctriFrom Fern
SpecThe project’s specapi.specs in generators.yml
SDK languagesOne SDK per generatorgroups in generators.yml
Package nameSDK package nameoutput.package-name
Project nameProject nameorganization in fern.config.json
Accent colour, logo, faviconDocs appearancedocs.yml
Guide pagesListed with their pathsnavigation in docs.yml
Method names, pagination, streamingPer-endpoint settingsx-fern extensions in your spec
Guide contentPage drafts, by Pull from GitHubYour MDX files

Step by step

  1. Export your definition

    Octri reads OpenAPI. If your API is written as a Fern Definition, run fern export first and keep the OpenAPI file it writes beside the fern folder.

  2. Bring it in

    Sign up, choose Switch to Octri when onboarding asks for your spec, and drop in a .zip of the repository with the fern folder and the OpenAPI file.

  3. Check the preview

    Before anything is created, Octri shows what it found: the spec, each generator as an SDK language, the package name, your theme, and every page in docs.yml with its path. Anything it could not carry is named in a note under the preview, so you know what is left to do by hand.

  4. Pull your guides from GitHub

    Connect the repository that holds your fern folder, then choose Pull from GitHub in the API Studio Files panel. Pick up to 50 Markdown or MDX files at a time and each lands as a page draft, with its title, description, icon and badge taken from the frontmatter. Switch on sync on push and later edits in Git keep landing on the same pages.

  5. Rename a few tags

    Most Fern components render as written. The handful that differ are in the table below, and the page preview shows each one as you fix it.

  6. Set up your SDKs

    Check each language in SDK Studio, where the preview shows every call, including the method names your x-fern extensions set. Give each language the package name your users already install, and publish the first Octri release as a new major version, since method names and types can change. Every later spec change arrives in the SDK repository as a pull request.

  7. Go live

    Publish, then point your custom domain at Octri last, so readers keep the old site until the new one is ready. From then on every merged spec change rebuilds the draft of your docs, SDKs and MCP tools, ready for you to publish.

Tags that change name

Note, Tip, Info, Warning, Callout, Card, CardGroup, Accordion, AccordionGroup, Steps, Tabs, ParamField and Frame render as written.

FernOctri
<CodeBlocks><CodeGroup>
<Files>, <Folder>, <File><FileTree>
<TabGroup><Tabs>
<Success>, <Error>, <Launch><Callout>

Questions

No. Fern joined Postman in January 2026 and still reads the same fern folder, so the files you upload here are the same ones Fern builds from.

Still deciding?

The comparison sets Octri against Fern row by row, from each product’s own pages, with Octri’s prices beside them.

Try it on your own spec

Bring what you have from Fern on the Free plan and see your reference written and your first SDK built.