{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/developer-portal/getting-started/","matchPath":"","result":{"data":{"markdownRemark":{"html":"<h1 style=\"position:relative;\"><a href=\"#getting-started-with-redocly-portal\" aria-label=\"getting started with redocly 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=\"getting-started-with-redocly-portal\"></div>Getting started with <strong>Redocly Portal</strong></h1>\n<p>This page lists steps to install and run the <strong>Portal</strong>.</p>\n<hr>\n<h3 style=\"position:relative;\"><a href=\"#before-you-begin\" aria-label=\"before you begin 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=\"before-you-begin\"></div>Before you begin</h3>\n<p>Before installing the <strong>Redocly Portal</strong>, make sure to do the following:</p>\n<ul>\n<li>\nInstall \n<a href=\"https://www.npmjs.com/get-npm\"><code class=\"language-text\">npm</code></a>\n or \n<a href=\"https://yarnpkg.com/lang/en/docs/install/#windows-stable\"><code class=\"language-text\">yarn</code></a>\n. These package managers work across all the major operating systems).\n</li>\n<li>\nKnow how to run the commands from the CLI (for example, \n<code class=\"language-text\">yarn install</code>\n). For Windows, we recommend using Git Bash.\n</li>\n<li>\nKnow the \n<a href=\"https://docs.gitlab.com/ee/gitlab-basics/start-using-git.html\">basic git techniques</a>\n (creating a branch, committing, and in our examples, opening a pull request on GitHub.)\n</li>\n<li>\nGet familiar with Markdown. We recommend using the \n<a href=\"https://code.visualstudio.com/download\">Visual Studio Code</a>\n application to manage your files.\n</li>\n</ul>\n<!-- /to do: add links to additional info to the each item./\nIf any of these assumptions are incorrect, please let us know and we can find resources to help you acquire that knowledge. -->\n<h3 style=\"position:relative;\"><a href=\"#install-the-portal\" aria-label=\"install the 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-portal\"></div>Install the Portal</h3>\n<ol>\n<li>\nClone the GitHub repository shared by Redocly.\n</li>\n</ol>\n<div class=\"code-wrapper\">\n        <div class=\"gatsby-code-button-container\"\n             data-toaster-id=\"88734746848906630000\"\n             data-toaster-duration=\"1500\"\n             onClick=\"copyCodeToClipboard(`git clone <url provided by Redocly>`, `88734746848906630000`)\"\n        >\n          <div class=\"gatsby-code-button\" title=\"Copy the code snippet\">Copy</div>\n          <div class=\"done-indicator done-indicator-88734746848906630000\">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 <span class=\"token operator\">&lt;</span>url provided by Redocly<span class=\"token operator\">></span></code></pre></div>\n      </div>\n<ol start=\"2\">\n<li>\nInstall the project.\n</li>\n</ol>\n<div class=\"code-wrapper\">\n        <div class=\"gatsby-code-button-container\"\n             data-toaster-id=\"34965461815053000000\"\n             data-toaster-duration=\"1500\"\n             onClick=\"copyCodeToClipboard(`yarn install`, `34965461815053000000`)\"\n        >\n          <div class=\"gatsby-code-button\" title=\"Copy the code snippet\">Copy</div>\n          <div class=\"done-indicator done-indicator-34965461815053000000\">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>Note:</h5></div><div class=\"admonition-content\"><p>If an error occurs during the installation, delete the <code class=\"language-text\">yarn.lock</code> file, and then try to install <strong>Redocly Portal</strong> again.</p></div></div>\n\n      <div class=\"code-snippets-tabs\" >\n    <div class=\"snippets-tabs-headers\">\n      <span class=\"tab-header active\" data-lang=\"bash\" data-snippet-id=\"Remove-yarn.lock\">Remove yarn.lock</span><span class=\"tab-header \" data-lang=\"bash\" data-snippet-id=\"yarn-install\">yarn install</span>\n    </div>\n    <div class=\"snippets-tabs-contents\">\n      <div class=\"tab-content active\" data-lang=\"bash\" data-snippet-id=\"Remove-yarn.lock\"><div class=\"code-wrapper\">\n        <div class=\"gatsby-code-button-container\"\n             data-toaster-id=\"3416403480041929700\"\n             data-toaster-duration=\"1500\"\n             onClick=\"copyCodeToClipboard(`rm yarn.lock`, `3416403480041929700`)\"\n        >\n          <div class=\"gatsby-code-button\" title=\"Copy the code snippet\">Copy</div>\n          <div class=\"done-indicator done-indicator-3416403480041929700\">Copied</div>\n        </div>\n        <div class=\"gatsby-highlight\" data-language=\"bash\"><pre class=\"language-bash\"><code class=\"language-bash\"><span class=\"token function\">rm</span> yarn.lock</code></pre></div>\n      </div></div><div class=\"tab-content \" data-lang=\"bash\" data-snippet-id=\"yarn-install\"><div class=\"code-wrapper\">\n        <div class=\"gatsby-code-button-container\"\n             data-toaster-id=\"95075090338707240000\"\n             data-toaster-duration=\"1500\"\n             onClick=\"copyCodeToClipboard(`yarn install`, `95075090338707240000`)\"\n        >\n          <div class=\"gatsby-code-button\" title=\"Copy the code snippet\">Copy</div>\n          <div class=\"done-indicator done-indicator-95075090338707240000\">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></div>\n    </div></div>\n    \n<p>If the installation problem persists, please contact the <a href=\"https://redoc.ly/contact-us\">Redocly support</a>.</p>\n<h3 style=\"position:relative;\"><a href=\"#run-the-portal\" aria-label=\"run the 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=\"run-the-portal\"></div>Run the <strong>Portal</strong></h3>\n<div class=\"code-wrapper\">\n        <div class=\"gatsby-code-button-container\"\n             data-toaster-id=\"93164373438567220000\"\n             data-toaster-duration=\"1500\"\n             onClick=\"copyCodeToClipboard(`yarn start`, `93164373438567220000`)\"\n        >\n          <div class=\"gatsby-code-button\" title=\"Copy the code snippet\">Copy</div>\n          <div class=\"done-indicator done-indicator-93164373438567220000\">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>You can now preview your files on the local server. The corresponding address will be displayed in the terminal.</p>","headings":[{"value":"Getting started with Redocly Portal","depth":1},{"value":"Before you begin","depth":3},{"value":"Install the Portal","depth":3},{"value":"Run the Portal","depth":3}]},"contentItem":{"data":{"lastModified":"2023-03-21T02:46:22.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":false,"disableLastModified":false,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"2f956ee0-80a5-5e96-9c6d-fcc53d566848__redocly content/developer-portal/getting-started/","seo":{"title":"Getting started","description":null,"image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"developer-portal/getting-started.md","pageBaseUrl":"/developer-portal/getting-started","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Getting started with Redocly Portal","id":"getting-started-with-redocly-portal"},{"depth":3,"value":"Before you begin","id":"before-you-begin"},{"depth":3,"value":"Install the Portal","id":"install-the-portal"},{"depth":3,"value":"Run the Portal","id":"run-the-portal"}]},"data":{"title":"Getting started"},"catalogInfo":null,"link":"/developer-portal/getting-started/","sidebarName":"","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}