I don't understand how to set up offline freecodecamp

wnch2 · May 1, 2019, 4:59pm

From the how-to-setup-freecodecamp-locally.md guide in github

Am I supposed to do the Installing prerequisites and Configuring dependencies parts first and then work my way down from Fork the repository on GitHub?

Or should I do Installing prerequisites without Configuring dependencies and then do the rest?

Thanks in advance guys

Dereje1 · May 1, 2019, 5:06pm

You mean setup locally right ? Follow the guide with docker, its newer and works better than the old guide

github.com

freeCodeCamp/freeCodeCamp/blob/master/docs/how-to-setup-freecodecamp-locally-using-docker.md

# Set up freeCodeCamp locally using Docker

Follow these guidelines for getting freeCodeCamp locally on your system. This is highly recommended if you want to be contributing regularly.

Some of the contribution workflows, like previewing pages for the guide or the coding challenges, debugging and fixing bugs in codebase, require you to have freeCodeCamp running locally.

This guide is new as of 8 March 2019 and we would appreciate if you can use it and let us know how well (or not) it worked for you. You can let us know in our [contributor's chat room](https://gitter.im/freeCodeCamp/Contributors).

This new setup procedure *should* result in fewer or no errors during the setup process and make it easier for you. We use Docker to install and run many of the software dependencies which means that you don't have to install things like MongoDB or MailHog on your computer or worry about getting those versions right.

## Fork the repository on GitHub

['Forking'](https://help.github.com/articles/about-forks/) is a step where you get your own copy of freeCodeCamp's main repository (a.k.a _repo_) on GitHub.

This is essential, because this way you are able to work on your copy of freeCodeCamp on GitHub, or download it for working locally. Later, you will be able to request changes to be pulled into the main repository via a pull request.

> **ProTip:**
> The main repository at `https://github.com/freeCodeCamp/freeCodeCamp` is often referred to as `upstream` repository.
> Your fork at `https://github.com/YOUR_USER_NAME/freeCodeCamp` is often referred to as `origin` repository.

This file has been truncated. show original

wnch2 · May 6, 2019, 11:04am

So I started the Docker guide but I’m stuck in the Installing dependencies part and have no idea what to do now.

Where it says: Then you have to bootstrap the docker images just one time to prepare them for running.

npm run docker:init
npm run docker:install
npm run docker:seed

Am I supposed to type this in a cmd in a specific folder or using the docker program itself?

Dereje1 · May 6, 2019, 11:07am

You are supposed to type it in your command line interface in the root folder of the project you pulled from git. If you are on a linux type system that would be bash, or (if like me) you are on windows then PowerShell would work.
Did you install Docker already ? What OS do you have ?

wnch2 · May 6, 2019, 1:55pm

I already installed Docker. My OS is Windows 10. I was able to run it and it seems to be going fine but it’s been stuck for like an hour on:
[ .] \ install dependencies: verb installed leaf @freecodecamp/client

wnch2 · May 6, 2019, 2:45pm

I have Windows Professional.

Dereje1 · May 6, 2019, 6:32pm

do you have a firewall ? I also have Windows 10 Pro , but I had to disable the firewall for docker to access the ports and for it to work

wnch2 · May 7, 2019, 6:06am

I tried disabling the firewall but I still some errors or warnings.

When running npm run docker:install this appears:

npm WARN acorn-jsx@5.0.1 requires a peer of acorn@^6.0.0 but none is installed. You must install peer dependencies yourself.
npm WARN @freecodecamp/freecodecamp@0.0.1 No repository field.
npm WARN @freecodecamp/freecodecamp@0.0.1 No license field.
npm WARN optional SKIPPING OPTIONAL DEPENDENCY: fsevents@1.2.4 (node_modules/fsevents):
npm WARN optional SKIPPING OPTIONAL DEPENDENCY: request to https://registry.npmjs.org/fsevents/-/fsevents-1.2.4.tgz failed, reason: getaddrinfo EAI_AGAIN registry.npmjs.org registry.npmjs.org:443
npm WARN optional SKIPPING OPTIONAL DEPENDENCY: nan@2.11.1 (node_modules/nan):
npm WARN optional SKIPPING OPTIONAL DEPENDENCY: request to https://registry.npmjs.org/nan/-/nan-2.11.1.tgz failed, reason: getaddrinfo EAI_AGAIN registry.npmjs.org registry.npmjs.org:443

And when I try to run npm run docker:develop:

Starting freecodecamp_client_1 ... error

ERROR: for freecodecamp_client_1  Cannot start service client: driver failed programming external connectivity on endpoint freecodecamp_client_1 (a11613fe23d154b86af7656c4469bef3af576aede25e067356080ffdcac5a3b6): Error starting userland proxy: mkdir /port/tcp:0.0.0.0:9228:tcp:172.18.0.4:9228: input/output error

ERROR: for client  Cannot start service client: driver failed programming external connectivity on endpoint freecodecamp_client_1 (a11613fe23d154b86af7656c4469bef3af576aede25e067356080ffdcac5a3b6): Error starting userland proxy: mkdir /port/tcp:0.0.0.0:9228:tcp:172.18.0.4:9228: input/output error
ERROR: Encountered errors while bringing up the project.
npm ERR! code ELIFECYCLE
npm ERR! errno 1
npm ERR! @freecodecamp/freecodecamp@0.0.1 docker:develop: `docker-compose up client api-server`
npm ERR! Exit status 1
npm ERR!
npm ERR! Failed at the @freecodecamp/freecodecamp@0.0.1 docker:develop script.
npm ERR! This is probably not a problem with npm. There is likely additional logging output above.

npm ERR! A complete log of this run can be found in:
npm ERR!     C:\Users\A\AppData\Roaming\npm-cache\_logs\2019-05-07T05_54_42_490Z-debug.log

Dereje1 · May 7, 2019, 11:37am

Hard to troubleshoot this from here, however, if you did notice a change in the errors after disabling the firewall, likely that is what is causing you the problem and not the source, I would , delete the entire folder , do a fresh new pull , disable the firewall, run docker and then follow all the instructions again, I remember having to do this a couple of times. Also you may get more direct assistance here: https://gitter.im/FreeCodeCamp/Contributors

wnch2 · May 7, 2019, 7:12pm

Well I tried a second time without running npm ci --ignore-scripts and got different warnings but the page opens and all is working great, won’t mess with making changes to your clone part though since it looks too complicated but I can just re-do it when I have internet access again so I’m good with this. Thanks a lot for the help!

Dereje1 · May 7, 2019, 7:28pm

yeah firewall seems to be an issue with Windows and setting up docker, by any chance are you using Norton 360 smart fire wall ?

wnch2 · May 7, 2019, 8:48pm

I’m not, just using the Windows default one, the first time I did it it did ask permission but I think it just ignored it and it did nothing

whygithubenterprise · August 21, 2019, 10:27pm

Can confirm that this has something to do with the firewall (at least for me). I’m on Ubuntu 19.04 and after running sudo npm run docker:install (yes, I had to use sudo) I also got stuck at
[ .] \ install dependencies: verb installed leaf @freecodecamp/client

When I disabled my firewall with sudo ufw disable the problem was solved.

Topic		Replies	Views
Deploying Fork of FreeCodeCamp to Remote Server Contributors	4	367	June 1, 2021
Setting up FCC on Windows Contributors	10	1429	January 17, 2021
Configuring freecodecamp offline Contributors	9	2561	January 17, 2021
How to use freecodecamp without getting connected to Internet?	5	1325	June 1, 2021
Docker guide & Mailhog Contributors	4	1094	January 17, 2021

I don't understand how to set up offline freecodecamp

Related topics