Skip to content

alternative dfx installation #3

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

alternative dfx installation #3

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
44 changes: 44 additions & 0 deletions guides/II.MD
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,50 @@ For developers who need to deploy **Internet Identity** on their local environme
```
DFX_VERSION=0.14.3-beta.0 sh -ci "$(curl -fsSL https://internetcomputer.org/install.sh)"
```
## Troubleshooting dfx setup
If you get any errors while installing dfx and can't solve them you can try this installation method and work with CLI inside a container with its own environment isolated from the main system. Using this method you can exerment with the installation inside the container without the risk of breaking something inside your OS.
### Install Docker
If the `docker -v` command outputs something like
```
Docker version 24.0.2 ...
```
then skip the Docker installation step and go straight to the next step.
Go to the link and follow the instructions to install:
```
https://docs.docker.com/engine/install/ubuntu/#install-using-the-repository
```

### Create an isolated environment
In VS code, open the extensions panel enter `Dev Containers` in the search and install the extension from Microsoft verified publisher.

Once the extension is installed, go to `View -> Command Palette` and type `(re)open folder in container`.

At the prompt opens, type Ubuntu and hit enter then select `jammy` and hit enter and then click `OK`.

After downloading the images, docker will create a new container based on Ubuntu 22.04 lts and connect the project directory to it.
Now you are working in the container and your terminal should look something like this:
```
vscode ➜ /workspaces/typescript-bootcamp (main) $
```

### Setup nodejs using nvm
To work with `azel` you also need to install `nodejs`. The easiest way to do this is to use node version manager(`nvm`). Here is a complete guide for different operating systems
```
https://www.freecodecamp.org/news/node-version-manager-nvm-install-guide/
```

Enter this command in the terminal
```
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
```

This command will download and run the `nvm` installation script and add it to the `PATH` variable.

Type `source ~/.bashrc` in the terminal for the changes to take effect and install the latest recommended version of `nodejs`(18.17.1 at this time) using this command ```nvm install 18.17.1```.

You are ready to go!

Go back to the previous point and install dfx as suggested.

## Step 1: Add Internet Identity Into Your Project
In your dfx.json file, locate the canister section and include the following code block:
Expand Down