> For the complete documentation index, see [llms.txt](https://docs.crynux.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.crynux.io/node-hosting/start-a-node/start-a-node-vast.md).

# Start a Node - Vast

Start a node on Vast.ai

The Crynux Node can be easily started on cloud services, such as [Vast.ai](https://vast.ai/), who supports starting a VM using Docker images directly. The steps to start a node on those services are quite similar. We will use Vast.ai as an example to show the complete steps to start a Crynux Node.

## 1. Start the container using template

We have already created the template for the Crynux Node on Vast, just use this template to start the node:

{% embed url="<https://cloud.vast.ai/?ref_id=136043&template_id=bba3743eb66fac590ab6a9de83158f4b>" %}

The content of the template is shown below:

<figure><img src="https://1099363499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fow8Hv7VFImRi1aXapa0H%2Fuploads%2FV0iX0lOK0Rhh6UaLw9Qv%2Fe2e99275247966afe9197eee2f70218.png?alt=media&amp;token=ab14747f-131e-4aaf-b737-872dfcf043ce" 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 3.6.0 version of the Crynux Node under Robinhood Network, use the image link below:

`ghcr.io/crynux-network/crynux-node:3.6.0-rh`
{% endhint %}

Some other config options that worth highlighting:

* Expose port `7412` for WebUI.
* Use the default docker ENTRYPOINT to start the container. Do not use interactive shells.

After selecting your desired hardware, and starting the instance, find the instance in the `INSTANCES` tab:

<figure><img src="https://1099363499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fow8Hv7VFImRi1aXapa0H%2Fuploads%2FQo3YT3XH65uncsIVjky9%2Fc35f22fdcc91d9906363314ce7ff526.png?alt=media&amp;token=a6e1e265-4011-4d13-a96a-55f387f0f624" alt=""><figcaption></figcaption></figure>

Wait until the container finishes initialization, and shows the `RUNNING` status.

## 2. Find the URL to access the WebUI

Click on the network info button to show the detailed ip address and ports:

<figure><img src="https://1099363499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fow8Hv7VFImRi1aXapa0H%2Fuploads%2FemzMUIhZw8dvUvbIcICT%2Fimage.png?alt=media&amp;token=654b27d7-ad98-48d8-95a9-f6cb529d5160" alt=""><figcaption></figcaption></figure>

The URL to access the WebUI will be shown in the popup:

<figure><img src="https://1099363499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fow8Hv7VFImRi1aXapa0H%2Fuploads%2FB4IZ9xeiYo6NwAcsmRQ2%2Fimage.png?alt=media&amp;token=c16fac54-a8f7-4e31-bf05-87cb80054d38" alt=""><figcaption></figcaption></figure>

In this case, the URL of the WebUI is `http://213.181.122.2:40021`. Just open it in a browser window, you should see the WebUI of the Node:

<figure><img src="https://1099363499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fow8Hv7VFImRi1aXapa0H%2Fuploads%2FbRuH79eZTPpyuvks5rMY%2F1d2593321953160bab0838ed3d54748.png?alt=media&amp;token=215e7d7a-879d-4586-b44e-e7d141cb8cc8" alt=""><figcaption></figcaption></figure>

## 3. Prepare the wallet

{% hint style="danger" %}

#### Security Warning: Private key on third‑party machines

When you run a node on Vast, your Docker container is not on your own hardware. It runs on GPU machines owned and operated by other individual Vast users. Any private key you put into the container is therefore stored on those third-party machines, where a malicious host or malware on the host system could read the key and immediately transfer all funds controlled by it.

To reduce potential loss, you **MUST** set up a **Beneficial Address** so that all rewards and returned stake are paid to a separate cold wallet, and only keep the minimum necessary balance on the hot key used by the node. Please find the details of the Beneficial Address in the docs below:

[Private Key Security](https://docs.crynux.io/node-hosting/private-key-security.md)
{% endhint %}

A wallet with enough CNX 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. Join the Crynux Discord to learn more about acquiring CNX tokens and starting a node.

<figure><img src="https://1099363499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fow8Hv7VFImRi1aXapa0H%2Fuploads%2FtIStgcl2dkiqgDS6xNnV%2F7b8bf34cf8eb9b7e850aad28e44b587.png?alt=media&amp;token=592b8844-9126-4ce7-85ea-ab43e55d0fd9" alt=""><figcaption></figcaption></figure>

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

## 4. 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="https://1099363499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fow8Hv7VFImRi1aXapa0H%2Fuploads%2FODTh6HVZn7Ta0RXTBDsJ%2F1daf6bc8396c38c44072803a2924d09.png?alt=media&amp;token=4d1602d1-f915-46d3-a98c-336da7435184" alt=""><figcaption></figcaption></figure>

## 5. 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="https://1099363499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fow8Hv7VFImRi1aXapa0H%2Fuploads%2FdnNba3LZMgMJP0lipkrh%2F6c659fa275de50dfa6fa82fae3f97d6.png?alt=media&amp;token=075c354c-66c0-4171-b101-5c0bbc01cf10" 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
