{"_id":"58734da07921150f0057dd63","project":"55a6e72e8cc73e0d00096635","user":"55a6caa022cfa321008e01d6","parentDoc":null,"version":{"_id":"55a6e72f8cc73e0d00096638","project":"55a6e72e8cc73e0d00096635","hasReference":false,"__v":29,"hasDoc":true,"createdAt":"2015-07-15T23:05:19.125Z","releaseDate":"2015-07-15T23:05:19.125Z","categories":["55a6e7308cc73e0d00096639","55b7ed07aea7c8190058badb","5604567c0c78b00d0039b191","5605e6f23a93940d002b3e4a","5605f2bba4574a0d00811365","5605f309a4574a0d00811366","5608e3b98aedf50d0004cf8f","5608e4318aedf50d0004cf90","5608e6b5a7cc2f0d00d9754d","5608e6d331beb60d001b6560","5608f879a7cc2f0d00d97580","560b097887b71d0d000d3bd9","560b13cbafa0990d00979545","560b5cbec341310d00de2a01","560b5cd0c341310d00de2a02","566a35b81e08750d00a0c49b","566a3e8503b4b20d00d02a4a","567889d307bf6a0d0083edc8","569c8b7c15bb390d00db6f9d","56b254dc65ddf50d0076ba8f","57a8ebc4cdeea20e001d2a63","57e48a4000c8680e00fae6e7","5808216773557d0f00a1e428","58105ad54a8aa50f00aa4cba","58105bf298aea40f00afa3ba","58105f548a4aed0f00d67536","581061b898aea40f00afa3be","584b3de7e5f3a42300df6ef7","596839a75965d400155bb750"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"__v":0,"category":{"_id":"5605f2bba4574a0d00811365","__v":26,"pages":["5608e4d6c5cff70d007d00d5","5608e4e7c5cff70d007d00d8","5608e4fbc5cff70d007d00da","5608e5096d8c440d000c79f3","5608e5156d8c440d000c79f6","5608e52331beb60d001b6558","5608e8248aedf50d0004cf98","5608e87e8aedf50d0004cf9b","5609bf4f9f85a70d00908530","562822dd5cfea90d00ddc5d7","562831c40653060d00a2f750","563d2732260dde0d00c5eab1","5660d2bee163310d006b19c1","567bb35b93919f0d00c97b1c","567bba643241c20d00b730de","567bbc14b56bac0d0019d933","567bc0473241c20d00b730e5","568b6bd8fe6fcc0d006dc8f7","56a427125fb2530d00421b67","56a42a5194ec0a0d00b3a012","56a42aaa545bc50d000e3ada","56ddff97bea78e20003a778f","56de00ab26744429006648ba","56de12a33168720e00c11b02","56e37f388b32a10e00f79755","56e73362e622c90e00dc55b3"],"project":"55a6e72e8cc73e0d00096635","version":"55a6e72f8cc73e0d00096638","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-09-26T01:19:55.795Z","from_sync":false,"order":2,"slug":"installation-and-launch","title":"Installation and Launch"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-01-09T08:45:20.963Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":3,"body":"<span id=\"Prerequisites\">To smoothly set up Stencil on Linux, please first verify the requirements listed here: </span>\n\n* [Root Permissions](#root_linux)\n* [Git Client](#git_linux)\n* [Node.js](#Node+npm_Linux)\n* [Next Steps](#next)\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"* These instructions have been tested on Linux/Ubuntu v.14.04.4. Dependencies for other platforms will be added upon further testing.\",\n  \"title\": \"Platform Support\"\n}\n[/block]\n## <span id=\"root_linux\"> 1. Root Permissions </span>\n\nYou should have administrator/root permissions on your machine. (If not, you might need to precede some commands below with the `sudo` prefix.) \n\n## <span id=\"git_linux\"> 2. Git Client </span>\n\nYou must have a <a href=\"https://git-scm.com/downloads\" target=\"_blank\">Git client</a> installed.\n\n## <span id=\"Node+npm_Linux\"> 3. Node.js </span>\n\nStencil requires the <a href=\"https://nodejs.org/\">Node.js</a> runtime environment, version <a href=\"https://nodejs.org/en/blog/release/\">4.x through 7.x</a>. On Linux, we have tested Stencil on selected Node.js versions, from <a href=\"https://nodejs.org/en/blog/release/v4.1.2/\">4.1.2</a> through <a href=\"https://nodejs.org/en/blog/release/v6.10.3/\">6.10.3</a> to <a href=\"https://nodejs.org/en/blog/release/v7.9.0/\">7.9.0</a>.\n      \nWe recommend that you install or update Node.js using <a href=\"https://github.com/creationix/nvm#installation\">nvm</a> (Node Version Manager), version <a href=\"https://github.com/creationix/nvm/tree/v0.28.0\">0.28.0</a>. \nFirst install nvm, using this command:<br>\n\n```\ncurl -o- https://raw.githubusercontent.com/creationix/nvm/v0.28.0/install.sh | bash\n```\n\nNext, explicitly install a supported Node.js version, using this convention: \n\n```\nnvm install 4.1.2\n```\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Notes on Dependencies\",\n  \"body\": \"* You can choose to instead download the latest x.x version of Node.js from the Node.js Foundation's archives, using URLs of the form: https://nodejs.org/dist/latest-v4.x/, https://nodejs.org/dist/latest-v7.x/, etc. In&#160;all cases, we recommend installing only LTS (\\\"Long-Term Support\\\"/\\\"Mature and Dependable\\\") versions.\\n\\n* While alternate versions of dependencies might also support Stencil, BigCommerce does not offer technical assistance on substitutions for, or customized versions of, the tested dependencies listed here.\\n\\n* Once Stencil is fully installed, you can check dependencies' installed versions by examining your \\n<span class=\\\"inline-code\\\">&lt;theme-name&gt;/package.json</span>file.\\n\\n* If you run into any problems with Stencil installation or launch, please first see our [Troubleshooting Your Setup](/docs/troubleshooting) page. Next, please consult our [Support](https://developer.bigcommerce.com/support/) resources, which include community/peer support via BigCommerce and Stack Overflow forums.\"\n}\n[/block]\n## <span id=\"next\" > 4. Next Steps </span>\n\nIn the next step, you will <a href=\"/docs/installing-stencil-cli-1\">install</a> the Stencil framework.","excerpt":"","slug":"prerequisites-linux","type":"basic","title":"Linux Prerequisites"}

Linux Prerequisites


<span id="Prerequisites">To smoothly set up Stencil on Linux, please first verify the requirements listed here: </span> * [Root Permissions](#root_linux) * [Git Client](#git_linux) * [Node.js](#Node+npm_Linux) * [Next Steps](#next) [block:callout] { "type": "info", "body": "* These instructions have been tested on Linux/Ubuntu v.14.04.4. Dependencies for other platforms will be added upon further testing.", "title": "Platform Support" } [/block] ## <span id="root_linux"> 1. Root Permissions </span> You should have administrator/root permissions on your machine. (If not, you might need to precede some commands below with the `sudo` prefix.) ## <span id="git_linux"> 2. Git Client </span> You must have a <a href="https://git-scm.com/downloads" target="_blank">Git client</a> installed. ## <span id="Node+npm_Linux"> 3. Node.js </span> Stencil requires the <a href="https://nodejs.org/">Node.js</a> runtime environment, version <a href="https://nodejs.org/en/blog/release/">4.x through 7.x</a>. On Linux, we have tested Stencil on selected Node.js versions, from <a href="https://nodejs.org/en/blog/release/v4.1.2/">4.1.2</a> through <a href="https://nodejs.org/en/blog/release/v6.10.3/">6.10.3</a> to <a href="https://nodejs.org/en/blog/release/v7.9.0/">7.9.0</a>. We recommend that you install or update Node.js using <a href="https://github.com/creationix/nvm#installation">nvm</a> (Node Version Manager), version <a href="https://github.com/creationix/nvm/tree/v0.28.0">0.28.0</a>. First install nvm, using this command:<br> ``` curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.28.0/install.sh | bash ``` Next, explicitly install a supported Node.js version, using this convention: ``` nvm install 4.1.2 ``` [block:callout] { "type": "info", "title": "Notes on Dependencies", "body": "* You can choose to instead download the latest x.x version of Node.js from the Node.js Foundation's archives, using URLs of the form: https://nodejs.org/dist/latest-v4.x/, https://nodejs.org/dist/latest-v7.x/, etc. In&#160;all cases, we recommend installing only LTS (\"Long-Term Support\"/\"Mature and Dependable\") versions.\n\n* While alternate versions of dependencies might also support Stencil, BigCommerce does not offer technical assistance on substitutions for, or customized versions of, the tested dependencies listed here.\n\n* Once Stencil is fully installed, you can check dependencies' installed versions by examining your \n<span class=\"inline-code\">&lt;theme-name&gt;/package.json</span>file.\n\n* If you run into any problems with Stencil installation or launch, please first see our [Troubleshooting Your Setup](/docs/troubleshooting) page. Next, please consult our [Support](https://developer.bigcommerce.com/support/) resources, which include community/peer support via BigCommerce and Stack Overflow forums." } [/block] ## <span id="next" > 4. Next Steps </span> In the next step, you will <a href="/docs/installing-stencil-cli-1">install</a> the Stencil framework.