Steps to get started on a Windows OS (If you already have an Ubuntu, skip to step 2):

1. Download Ubuntu form https://ubuntu.com/#download
2. Download Oracle VM VirtualBox from https://www.virtualbox.org/
3. Select “New” and fill out the information. Most of the things can be kept as the defaulted values. The Virtual Box should be able to pick up the downloaded Ubuntu or it makes its own
   • If this is a long-term thing for you, make sure you put enough storage on it (you CAN come back to the storage and increase or decrease its size!)
4. Open the Ubuntu box and complete the rest of the set up
   • If you have time, do the complete set-up
   • If not, do the shorter set-up (should be the second option)
5. After set-up is complete, click the “Ubuntu Software” on the menu on the left side(defaulted to the left and can be moved around)
6. Search for “Visual Studio Code” and install it

NOTE: If you want to have it on the menu as well, click the 9 dots on the bottom left corner (if your menu is still on the left side) and find VS Code. Right-click it and hit “Add to favorites”. Now it will stay on your menu tab

7. Next, open up Terminal

• Click the 9 dots on the bottom left corner and find “Terminal”

8. Here you want to install git. To do so, use the following commands in Terminal:

a. sudo apt update --- this will make sure your apt is up to date

1. You might be prompted to enter your password. Enter to do this command
2. FYI: sudo is basically allowing you to do root or admin level commands

b. sudo apt install git --- this will install git

9. Find the GitHub repository that you want to clone and copy it.

10. Now in VS Code, open a new window. There will be a button that says, “Clone git repository”. Click that and paste the GitHub repository into the box. Save it in a good spot.

11. Now back in the terminal, we need to install:

NOTE: If needed, close and reopen a new Terminal to see if the change occurred or not

1. asdf

   • In Terminal, write the command: sudo apt install curl git

   • Clone this git with this command:

     git clone https://github.com/asdf-vm/asdf.git ~/.asdf --branch v0.8.1

   • Then navigate to your bashrc file by doing this command:

     nano ~/.bashrc

   • Scroll all the way to the bottom and add the following lines:

     . $HOME/.asdf/asdf.sh

     . $HOME/.asdf/completions/asdf.bash

   • SAVE THE FILE!!!

   • Close and reopen a new terminal

2. node

   Way 1:

   • In Terminal, write the command: sudo apt install nodejs
   • To double check its installed, do the command: node -v or node -version

   Way 2:

   • In Terminal, write the command: asdf plugin add nodejs

3. direnv

   • In Terminal, write the command: sudo apt-get install direnv

   • Then in root, type the command: nano ~/.bashrc

   • Scroll all the way down and add the following lines:

     #direnv

     eval "$(direnv hook bash)"

   • SAVE THE FILE!!!

   • You MUST close and reopen the terminal for this install to work

   • You will know this works when you open up the project folder and there is a red warning saying you need to run: direnv allow

   • Run: direnv allow

   • If there are no results, then it was done incorrectly. Restart the process.

4. If you'll be working on legacy Yggdrasil repo then install yarn, else install pnpm (the same command just pnpm instead of yarn)

   • pnpm
     1. In the Terminal, write the command: npm install -g pnpm
     2. To update: pnpm add -g pnpm
   • yarn
     1. In the Terminal, type the command: sudo npm install yarn -g (g stands for global)
     2. To check, type**: yarn -v**
     3. To install yarn in your project, firstly in the home folder of your project, run: yarn install
     4. Then navigate to each service folder you are using and also run: yarn install

5. Go to npmjs.org and create an account. After creating an account, click the drop-down menu on the top right and click “Access Tokens”. Click “Generate New Token” and a new npm token will be generated for you. Click your token and it will be automatically copied.

6. Back in VS Code, create a new file in the service folder (e.g. midgard) called .env

7. In .env, you will type the following: NPM_TOKEN= <PASTE YOUR TOKEN HERE>

8. If your mentor wants you to do staging, they will tell you the other links to post here

9. MAKE SURE THE SAVE THE FILE!!!

10. Everything should be set up now. Start a brand-new terminal and do the following:

11. Navigate to your project

12. Make sure yarn is installed

13. Make sure to do: direnv allow

14. Make sure there are results

15. Navigate to the service you are working on

16. Make sure your node version is correct

17. Finally launch using: yarn dev

18. Open up any browser (preferably Google Chrome) and go to localhost:3004 (or whichever port the project is using). This will take a minute or a couple of seconds. Then you are on your way!