# Start a Node - Octa

The Crynux Node can be easily started on [Octa](https://marketplace.octa.space/) using Docker images.

## 1. Go to the Octa Marketplace and find the Crynux app

Visit the Octa Marketplace in a browser:

{% embed url="<https://marketplace.octa.space>" %}

Search for `Crynux` and click on the app:

<figure><img src="/files/gCPKbqegcDvYp7PPUNnD" alt=""><figcaption></figcaption></figure>

## 2. Select the GPU to start the Docker container

<figure><img src="/files/bdPu92c45v8Me0LvtX3c" alt=""><figcaption></figcaption></figure>

Select the GPU that fits your need. And then click "Configure".

## 3. Configure the Docker container

<figure><img src="/files/nbiCdlhOWpwkGAC5CnUl" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**Please use the latest version tag to start the container**

you could find the available tags at:

[**https://github.com/crynux-network/crynux-node/pkgs/container/crynux-node/versions**](https://github.com/crynux-network/crynux-node/pkgs/container/crynux-node/versions)

For example, if you want to run the 2.8.0 version of the Crynux Node under Near Network, use the image link below:

`ghcr.io/crynux-network/crynux-node:2.8.0-near`
{% endhint %}

Expose port `7412` for the remote access of the WebUI.

`100 GB` of disk space will be enough for normal operations of the node.

After you're done, click "Deploy" to start the Docker container:

<figure><img src="/files/CqCCYnLOQ5KY47fuNv88" alt=""><figcaption></figcaption></figure>

Once Octa pulls and prepares the image on the node, it will start the container. To track progress, check the `Status` field in the session item. For more detailed insights, click the `View logs` button in the `Actions` column.

<figure><img src="/files/EbVhK2yDLdi62ge1dYZa" alt=""><figcaption></figcaption></figure>

## 4. Find the URL to access the WebUI

Once the container has started, the `Status` will change to `Service configured`. Then, click on the session item to find the URL for accessing the WebUI:

<figure><img src="/files/Hx4gloAfAXcdLU18ELN4" alt=""><figcaption></figcaption></figure>

Click on the link below `HTTP Services`, and you will be redirected to the WebUI in the browser:

<figure><img src="/files/pigpuZSEs17CBXtn7Ksq" alt=""><figcaption></figcaption></figure>

## 5. Prepare the wallet

A wallet with enough test tokens must be provided to the node. If this is the first time you start a node, click the "Create New Wallet" button and follow the instructions to create a new wallet and finish the backup of the private keys:

<figure><img src="/files/7EUckTRp0bfLYj5p9ZyR" alt=""><figcaption></figcaption></figure>

### Get the test CNX tokens from the Discord Server

Some test CNX tokens are required to start the node. The test CNX tokens can be acquired for free in the Discord server of Crynux:

{% embed url="<https://discord.gg/y8YKxb7uZk>" %}

Follow the instructions in the following document to get the test tokens:

{% content-ref url="/pages/7BF1BqejWnxoI8XfziZA" %}
[Get the Test CNX Tokens](/node-hosting/get-the-test-cnx-tokens.md)
{% endcontent-ref %}

## 6. Wait for the system initialization to finish

If this is the first time you start a node, it could take quite a long while for the system to initialize. The most time consuming step is to download \~40GB of the commonly used model files from the Huggingface. The time may vary depending on your network speed.

After the models are downloaded, a test image generation task will be executed locally to examine the capability of your device. If the device is not capable to generate images, or the generation speed is too slow, the node will not be able to join the network. If the task is finished successfully, the initialization is completed:

<figure><img src="/files/9ifO8ZhSDPqFBgpJeg0v" alt=""><figcaption></figcaption></figure>

## 7. Join the Crynux Network

The Crynux Node will try to join the network automatically every time it is started. After the transaction is confirmed on-chain, the node has successfully joined the network. When the node is selected by the network to execute a task, the task will start automatically, and the tokens will be transferred to the node wallet after the task is finished.

<figure><img src="/files/jQlfE6EZrdMjZP3SUHv6" alt=""><figcaption></figcaption></figure>

Now the Node is fully up and running. You could just leave it there to run tasks automatically.

The Node could be paused or stopped at any time by clicking the control buttons. If the node is in the middle of running a task, after clicking the buttons, the node will go into the "pending" status and continue with the running task. When the task is finished, the node will pause/stop automatically.

The difference between pausing and stopping is that pausing will not cause the staked CNX tokens to be returned, so that the transaction costs less gas fee than stopping. If you have a plan of going back, you could use pausing rather than stopping.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.crynux.io/node-hosting/start-a-node/start-a-node-octa.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
