{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/developer-portal/setup/","matchPath":"","result":{"data":{"markdownRemark":{"html":"<h1 style=\"position:relative;\"><a href=\"#install-the-developer-portal\" aria-label=\"install the developer portal permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"install-the-developer-portal\"></div>Install the developer portal</h1>\n<h2 style=\"position:relative;\"><a href=\"#clone\" aria-label=\"clone permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"clone\"></div>Clone</h2>\n<div class=\"code-wrapper\">\n        <div class=\"gatsby-code-button-container\"\n             data-toaster-id=\"70674142823669326000\"\n             data-toaster-duration=\"1500\"\n             onClick=\"copyCodeToClipboard(`git clone git@github.com:Redocly/developer-portal-starter.git\n\ncd developer-portal-starter`, `70674142823669326000`)\"\n        >\n          <div class=\"gatsby-code-button\" title=\"Copy the code snippet\">Copy</div>\n          <div class=\"done-indicator done-indicator-70674142823669326000\">Copied</div>\n        </div>\n        <div class=\"gatsby-highlight\" data-language=\"bash\"><pre class=\"language-bash\"><code class=\"language-bash\"><span class=\"token function\">git</span> clone git@github.com:Redocly/developer-portal-starter.git\n\n<span class=\"token builtin class-name\">cd</span> developer-portal-starter</code></pre></div>\n      </div>\n<h2 style=\"position:relative;\"><a href=\"#install-dependencies\" aria-label=\"install dependencies permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"install-dependencies\"></div>Install dependencies</h2>\n<p>Before you start... you'll need node and yarn installed.</p>\n<ul>\n<li>\n<a href=\"https://nodejs.org/en/\">node.js >= 12</a>\n</li>\n<li>\n<a href=\"https://yarnpkg.com/en/\">yarn</a>\n</li>\n</ul>\n<div class=\"code-wrapper\">\n        <div class=\"gatsby-code-button-container\"\n             data-toaster-id=\"60873499653693090000\"\n             data-toaster-duration=\"1500\"\n             onClick=\"copyCodeToClipboard(`yarn install`, `60873499653693090000`)\"\n        >\n          <div class=\"gatsby-code-button\" title=\"Copy the code snippet\">Copy</div>\n          <div class=\"done-indicator done-indicator-60873499653693090000\">Copied</div>\n        </div>\n        <div class=\"gatsby-highlight\" data-language=\"bash\"><pre class=\"language-bash\"><code class=\"language-bash\"><span class=\"token function\">yarn</span> <span class=\"token function\">install</span></code></pre></div>\n      </div>\n<div class=\"admonition admonition-attention\"><div class=\"admonition-heading\"><h5><span class=\"admonition-icon\"><i></i></span>attention</h5></div><div class=\"admonition-content\"><p>Depending on your operating system, you may see warnings when installing dependencies.</p></div></div>\n<h2 style=\"position:relative;\"><a href=\"#start-the-development-environment\" aria-label=\"start the development environment permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"start-the-development-environment\"></div>Start the development environment</h2>\n<div class=\"code-wrapper\">\n        <div class=\"gatsby-code-button-container\"\n             data-toaster-id=\"63264591191192010000\"\n             data-toaster-duration=\"1500\"\n             onClick=\"copyCodeToClipboard(`yarn start`, `63264591191192010000`)\"\n        >\n          <div class=\"gatsby-code-button\" title=\"Copy the code snippet\">Copy</div>\n          <div class=\"done-indicator done-indicator-63264591191192010000\">Copied</div>\n        </div>\n        <div class=\"gatsby-highlight\" data-language=\"bash\"><pre class=\"language-bash\"><code class=\"language-bash\"><span class=\"token function\">yarn</span> start</code></pre></div>\n      </div>\n<p>This command will start a development server.\nMost functionality exists in the development server except for search.\nWhen the server is ready, the url will be published to the console.\nIt may default to <a href=\"http://localhost:3000\">http://localhost:3000</a>.\nOpen that in a browser to see this developer portal load.</p>\n<h2 style=\"position:relative;\"><a href=\"#stop-the-development-environment\" aria-label=\"stop the development environment permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"stop-the-development-environment\"></div>Stop the development environment</h2>\n<p>Press control and c.</p>\n<p><span\n      class=\"gatsby-resp-image-wrapper\"\n      style=\"position: relative; display: block; margin-left: auto; margin-right: auto; max-width: 464px; \"\n    >\n      <span\n    class=\"gatsby-resp-image-background-image\"\n    style=\"padding-bottom: 35.08771929824561%; position: relative; bottom: 0; left: 0; background-image: url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAHCAIAAACHqfpvAAAACXBIWXMAAAsTAAALEwEAmpwYAAABVklEQVQY0yWQTXKCQBSE51bmhF7AQ7iKKQ1ZiFqlDsoMgijCSBRBRvA/FFD+LNykK9kxvH7d32uSpqkQYr1eB5tNFEVSyl2SHA6H0+l0Pp9vt1tZlo/HA7Lv1SqMoljK/X5/PB7zPCeGMeGMh2G4CUMsYnC5XLB2vV6TNM2L4vV63e/38VifzWbb7RYumMIdSqIzhr+maVI6VFW13W5rmoZZlmVxLBGr6zrsNG28XPpgpJQCCslytyN4GIZRr9ebzaaiKLVarVqtDgYD2OMK3/crlbdGo4Hk+Xze6/WgRH4cxyAl/X5/NBohGQmLxcLzPMuybNtOkkSIZVGU+P7JMlXtQuO6Luccy0EQoALS6XTf3z8o1YZDCmDG2HRqO46DHNQBeNyMwlqtT0X5ggyYEHBuuK5HgIB7GIOjAW8MUIHjAEHA/r/t5/OJE0A+mZiWNf0DFCjiF8fSXEufepETAAAAAElFTkSuQmCC'); background-size: cover; display: block;\"\n  ></span>\n  <img\n        class=\"gatsby-resp-image-image\"\n        alt=\"control-c\"\n        title=\"control-c\"\n        src=\"/static/4bac76313d137b795df6dc5f4a96f66e/69096/ctrl-c.png\"\n        srcset=\"/static/4bac76313d137b795df6dc5f4a96f66e/d4770/ctrl-c.png 228w,\n/static/4bac76313d137b795df6dc5f4a96f66e/379c3/ctrl-c.png 455w,\n/static/4bac76313d137b795df6dc5f4a96f66e/69096/ctrl-c.png 464w\"\n        sizes=\"(max-width: 464px) 100vw, 464px\"\n        style=\"width:100%;height:100%;margin:0;vertical-align:middle;position:absolute;top:0;left:0;\"\n        loading=\"lazy\"\n      />\n    </span></p>\n<h2 style=\"position:relative;\"><a href=\"#clearing-cache\" aria-label=\"clearing cache permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"clearing-cache\"></div>Clearing cache</h2>\n<div class=\"admonition admonition-warning\"><div class=\"admonition-heading\"><h5><span class=\"admonition-icon\"><i></i></span>warning</h5></div><div class=\"admonition-content\"><p>Troubleshooting? Try this out.</p></div></div>\n<p>A few changes (such as changing the key of a sidebar definition) require clearing cache to reflect in the local server.\nWe actively reduce these to make the best development environment experience possible.</p>\n<ol>\n<li>\nPress control-c.\n</li>\n<li>\nRun \n<code class=\"language-text\">yarn clean</code>\n in the command prompt to clear the cache.\n</li>\n<li>\nRun \n<code class=\"language-text\">yarn start</code>\n again.\n</li>\n</ol>\n<h2 style=\"position:relative;\"><a href=\"#next-steps\" aria-label=\"next steps permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"next-steps\"></div>Next steps</h2>\n<p>You are ready to train!</p>\n<p>Go to the <a href=\"/developer-portal/\">training exercises list</a>.</p>","headings":[{"value":"Install the developer portal","depth":1},{"value":"Clone","depth":2},{"value":"Install dependencies","depth":2},{"value":"Start the development environment","depth":2},{"value":"Stop the development environment","depth":2},{"value":"Clearing cache","depth":2},{"value":"Next steps","depth":2}]},"contentItem":{"data":{"lastModified":"2025-12-17T21:55:39.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":true,"disableLastModified":false,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"30778a65-bfc4-5322-9a80-d2b7374d4dbe__redocly content/developer-portal/setup/","seo":{"title":"Install the developer portal","description":null,"image":"","keywords":null,"jsonLd":null,"lang":null},"pageId":"developer-portal/setup.md","pageBaseUrl":"/developer-portal/setup","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Install the developer portal","id":"install-the-developer-portal"},{"depth":2,"value":"Clone","id":"clone"},{"depth":2,"value":"Install dependencies","id":"install-dependencies"},{"depth":2,"value":"Start the development environment","id":"start-the-development-environment"},{"depth":2,"value":"Stop the development environment","id":"stop-the-development-environment"},{"depth":2,"value":"Clearing cache","id":"clearing-cache"},{"depth":2,"value":"Next steps","id":"next-steps"}]},"data":{"title":""},"catalogInfo":null,"link":"/developer-portal/setup/","sidebarName":"","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1180902673","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3743992808","561138138"]}