# Worker Node - Quick Start Guide

## Subscription

To set up a new Worker node, you will need to purchase a subscription.&#x20;

To subscribe:

1. Verify that you are in the VaaS environment of Launchpad by checking the toggle button on the top right. You will easily recognize the VaaS environment by its dark theme

<div align="left"><figure><img src="https://content.gitbook.com/content/tVv4gal2xiLAecbIlZ7d/blobs/P4nXzTP62Bhsshez8Vhm/Screenshot%202024-06-11%20at%2011.24.22.png" alt="" width="170"><figcaption></figcaption></figure></div>

2. Under **Worker Node** in the left hand bar, go to "**Purchase**" and fill in the purchase form

<div align="left"><figure><img src="https://content.gitbook.com/content/tVv4gal2xiLAecbIlZ7d/blobs/4x4vAMHVS1ydnQaTxuAl/Screenshot%202024-09-23%20at%2013.22.24.png" alt="" width="563"><figcaption></figcaption></figure></div>

3. Click on the "**Subscribe**" button. You will be redirected to the payment page.
4. Once the payment is completed, you are ready to set-up your Worker Node.

***

## Full Node Deployment Guide <a href="#full-node-deployment-and-management" id="full-node-deployment-and-management"></a>

Once you have purchase one or more Worker Nodes, you are ready to deploy them.

1. Under **Worker Node** > "**Manage**", look for "**Pending deployments**" at the top of the page. You will find all newly purchased Worker Nodes that have not yet been deployed. Previously deployed nodes that were deleted will also show up here.

<div align="left"><figure><img src="https://content.gitbook.com/content/tVv4gal2xiLAecbIlZ7d/blobs/y6IZvSPJoRCcoBZTBq6y/Screenshot%202024-09-23%20at%2013.27.38.png" alt="" width="178"><figcaption></figcaption></figure></div>

2. Click on "**Deploy**" to start setting up your Worker node
3. The first step required is to fill in the basic **Node details: Name and Region**. The name should have a minimum of 6 characters and can contain spaces.

<div align="left"><figure><img src="https://content.gitbook.com/content/tVv4gal2xiLAecbIlZ7d/blobs/dDGXoSledunhwsW2WC3z/Screenshot%202024-09-23%20at%2013.30.14.png" alt=""><figcaption></figcaption></figure></div>

4. The second step is the **IPFS Gateway**. By default, you are always able to choose a **Public IPFS gateway**. Private and BYOC (bring your own credentials) for IPFS support will come in near future. Note that you can deploy your node with a Public gateway and change that setting in the future.

<figure><img src="https://content.gitbook.com/content/tVv4gal2xiLAecbIlZ7d/blobs/SV5kb9uLujJfTDbADGq8/Screenshot%202024-09-23%20at%2013.32.20.png" alt=""><figcaption></figcaption></figure>

5. The third and last steps asks you to configure your **Account**. You can do that by either **bringing your own keys** should you already have an account you wish to use, or **generate new keys**. To bring your own keys, you will need the 12 words seed phrase. \
   **The account keys can be re-generated or imported even after deployment**.\
   \
   \&#xNAN;*\*\*\*\*\*\**\
   *Side note - if you already have a running worker node behind marketplace desktop app, you can use the same Worker Account here as the one that you use on your local environment. Just remember to pause your Marketplace app worker engine after the set-up here is completed.* \
   \
   *You can always remove Launchpad Worker Node and re-enable Marketplace app worker at any time.* \
   \
   *Both workers can be enabled at the same time temporarily, but it will cause them to compete against each other and might cause unpredictable voting behaviour, hence this is not recommended.* \
   *\*\*\*\*\*\**

<figure><img src="https://content.gitbook.com/content/tVv4gal2xiLAecbIlZ7d/blobs/xZt5gUEf7t8cTgEwS85N/Screenshot%202024-09-23%20at%2013.34.52.png" alt=""><figcaption></figcaption></figure>

6. Click **Continue**, you will be offered to be redirected to your **Manage** page.
7. Your newly deployed node will show in the **Worker Nodes** table with the status "**Requested**"

<figure><img src="https://content.gitbook.com/content/tVv4gal2xiLAecbIlZ7d/blobs/9ZAP7LUojyhkIgM7HHvj/Screenshot%202024-09-23%20at%2013.38.12.png" alt=""><figcaption><p>Node overview including status</p></figcaption></figure>

8. After several minutes, you will receive a notification regarding the **provisioning** of your Worker node, and its status will change to "**Provisioning**". You can already access your node details via the **"i" icon** on the right of your node overview.

<div align="left"><figure><img src="https://content.gitbook.com/content/tVv4gal2xiLAecbIlZ7d/blobs/5zOCbO3jOWvOzOZRPIS4/Screenshot%202024-09-23%20at%2013.41.10.png" alt="" width="375"><figcaption><p>Notification</p></figcaption></figure></div>

<figure><img src="https://content.gitbook.com/content/tVv4gal2xiLAecbIlZ7d/blobs/tlnQDoxJhGExPR8iwhOS/Screenshot%202024-09-23%20at%2013.41.15.png" alt=""><figcaption><p>Node overview including status</p></figcaption></figure>

9. Within 15 minutes, your node will switch to the "**Ready**" status and you will be notified
10. After your node is properly set-up & provisioned, in details page you should see green \
    "Running - waiting for Subscribtion"  - which indicates that Worker Account configured for that worker should be still linked to Operator Account.\
    \
    If you have used  Worker Account that was previously linked to an Operator Account you should see "Running" status.

***

## Linking Worker Account to Operator Account & Operator Console

Once your node provisioning is completed the remaining actions should be conducted either by Marketplace App/WebApp or directly with chain interactions.

To innitiate Marketplace App/WebApp based Worker Account <> Operator Account linking, go to Worker Node details page, and click "Open Operators Console".

<figure><img src="https://989391867-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtVv4gal2xiLAecbIlZ7d%2Fuploads%2F3BxMfmEvCoZflLvFmDwL%2FZrzut%20ekranu%202024-12-10%20o%2015.06.55.png?alt=media&#x26;token=912bdfca-ddcd-449d-809b-c4bcf02b6af0" alt=""><figcaption></figcaption></figure>

Once oppened, choose desired option and proceed with accounts linkage.&#x20;

<figure><img src="https://989391867-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtVv4gal2xiLAecbIlZ7d%2Fuploads%2FTtjzZjumqRyyZGsBgE9m%2FZrzut%20ekranu%202024-12-10%20o%2015.07.40.png?alt=media&#x26;token=fbe96433-3f6f-47d9-89a7-aafb0a372e4c" alt=""><figcaption></figcaption></figure>

Full instruction on how to Link Operator and Worker account Using above options is provided [here](https://docs.energyweb.org/ewx-ecosystem/worker-nodes/the-marketplace-app/setting-up-a-server-based-worker-node-account) . \
\
This concludes necessary actions that should be taken on Launchpad side, the remaining operations should be conducted with Operators Account using any of the available Marketplace app options.
