# Set up the ThingsBoard front-end environment locally

<br/>

## Step 1 - Clone single branch

git clone --branch <branchname> --single-branch <remote-repo-url>

//or

git clone -b <branchname> --single-branch <remote-repo-url>

* Sample

$ git clone -b release-3.6 --single-branch https://github.com/thingsboard/thingsboard.git

<br/>

## Step 2 - NPM install or Yarn install
After cloning the repository, move to the `ui-ngx` folder since `ui-ngx` folder placed the front-end source code.
* Install packages
* Use `yarn install` or `npm install` to download the package
* Common issue: Confliction of Angular module version

* Confliction Issue:
`yarn install --ignore-engines` does not work in this case, you still need to upgrade your Node.js version
* Upgrade Node.js
* Use nvm to manage and switch between different versions of Node.js
* You can also use nvm to install a new version of Node.js
* [How to use nvm?](https://medium.com/@wserena33116/nvm-node-version-manager-414227e79d8e)
* After installation, run `npm install` again

<br/>

## Step 3 - Change environment variables in the proxy config

* In `proxy.conf.js` file

// default setting
const forwardUrl = "http://localhost:8000";
const wsForwardUrl = "ws://localhost:8000";

// sample
const forwardUrl = "http://192.168.1.205:8080"; 
const wsForwardUrl = "ws://192.168.1.205:8080";
// url is dependent on your ThingsBoard server