Will someone help with the move?

Yes. Book a call and a founder will go through your project with you and help the first release over by hand. Questions also reach us at founders@octri.dev.

Migration guide

Migrate from Scalar to Octri

The move starts from two things a Scalar project already has: the OpenAPI document its reference is built from, and its guides as Markdown and MDX.

Start on the Free plan Book a call

Written by Octri · Checked 25 October 2026

What to have to hand

Your OpenAPI file, and your Markdown in a GitHub repository. Everything else is set in API Studio and SDK Studio.

openapi.json
guides/*.mdx

What comes across

Scalar has no config for Octri to read, so the move runs on files you already have. Rows marked “By hand” are what is left for you.

What	In Octri	From Scalar
API reference	A page for every endpoint, written for you	Your OpenAPI file
Guides	Page drafts, by Pull from GitHub	Your Markdown and MDX in Git
Redirects	octri.json	Your Scalar redirects, by hand
Logo, colours and fonts	Set in API Studio	By hand
SDKs	Generated in the languages you pick	Nothing to bring

Step by step

Bring the spec
Sign up and upload the OpenAPI document from your Scalar registry, or connect the repository it lives in.
Pull your guides from GitHub
Connect the repository that holds your Scalar guides, 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.
Set up your SDKs
Pick your languages in SDK Studio. If you publish Scalar SDKs today, give each language the same package name. 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.
Keep your old links working
Open octri.json in the Files panel and add a redirect for each old path. A rule that ends in /* covers a whole section, and a project keeps up to 500 of them.
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.

Questions

No. The importer only reads the files you upload, and Pull from GitHub only reads your repository. Nothing is written back to either, so your current site keeps running until you move the domain.