> For the complete documentation index, see [llms.txt](https://docs.presearch.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.presearch.io/nodes/setup/vps-setup/running-a-node-on-stack-os.md).

# Running a node on Stack OS

Here is a quick guide to launching your PreSearch Node on StackOS.

We assume you already have your PreSearch Node Registration Code and account set up.  If you need more details on that reference this: <https://docs.presearch.org/nodes/setup>\
\
Go to your [Node's dashboard](https://nodes.presearch.com/dashboard) and have your Presearch Node Registration Code ready.

## Fund your StackOS Account:

Go to <https://app.stackos.io/> and login with Metamask

* BSC MainNet
* Choose Cluster:
  * Dev/Test: Titan or Matrix Cluster
  * Production: Authority for high uptime deploys

Go to the upgrade tab:

![](https://881106330-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS4taefedlYJ7UrPHAo%2Fuploads%2FFJeXJ76PnwkC6eBajA0B%2Fstackos%20presearch%20upgrade%20menu.png?alt=media\&token=c0d8cb0e-97db-4164-a343-60195d8c05de)\
Type in the following information

![](https://881106330-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS4taefedlYJ7UrPHAo%2Fuploads%2FZf2C3CJTtxubmNZIeZiU%2Fstackos%20presearch%20upgrade%20package.png?alt=media\&token=1b9ed57b-4b2a-45ba-93ac-0b767a4d4559)\
As a note, we can assign the resources as follows:  &#x20;

* CPU as follows: 2000 for PreSearch, 100 for webtty  &#x20;
* RAM: 4000 for PreSearch, 100 for webtty &#x20;
* Disk: 16-32 GB for PreSearch\
  \
  You will be given a quote for the number of $STACK tokens you need to deposit.\
  Buy some $STACK tokens from Pancake Swap and deposit that amount into StackOS<https://medium.com/stackos/how-to-buy-stack-on-pancakeswap-using-metamask-3e122dc04061>\
  \
  Click the Deposit or Upgrade button to fund your StackOS account![](https://881106330-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS4taefedlYJ7UrPHAo%2Fuploads%2FZa6c7FuSExJcOYxBEyZh%2FScreen%20Shot%202022-01-10%20at%2011.41.51%20AM.png?alt=media\&token=849f74d4-3476-4fd2-b3b4-84d0807a30fc)

## Go to the AppStore

![
](https://881106330-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS4taefedlYJ7UrPHAo%2Fuploads%2FHnG5bTCZQ0Whfa89n1Dv%2Fimage.png?alt=media\&token=39e52589-0945-4312-803e-60600a8f6238)

## Launch your PreSearch Node

![](https://881106330-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS4taefedlYJ7UrPHAo%2Fuploads%2FIkcBihYN6dhrNcLVeKC7%2Fimage%20\(1\).png?alt=media\&token=b8fec8ce-2bc4-4646-9684-ec1cb9b5a17a)

![](https://881106330-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS4taefedlYJ7UrPHAo%2Fuploads%2FhKjcd2THzflV6EJzfxen%2Fimage%20\(2\).png?alt=media\&token=6da7b4d4-0934-452d-bf90-c4bc1b2a23a1)

![](https://881106330-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS4taefedlYJ7UrPHAo%2Fuploads%2F3AeGFR6sFE0HKwbpxUqU%2FScreen%20Shot%202022-01-11%20at%204.16.57%20AM.png?alt=media\&token=b298a5bf-4ff6-445e-a56e-cfcb5de5f57b)

## Verify Operation

\
Check <https://nodes.presearch.com/dashboard> and verify your node appears on the list

![](https://881106330-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS4taefedlYJ7UrPHAo%2Fuploads%2FHcQpA97IAMKYeao9eGC1%2Fimage%20\(4\).png?alt=media\&token=a587ccfe-c460-4706-8aa6-f079c7d502b4)

Look for green connection icon

![](https://881106330-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS4taefedlYJ7UrPHAo%2Fuploads%2FDiHwU6le2lEa3GLukOE1%2Fimage%20\(5\).png?alt=media\&token=0c2acf84-4f92-4beb-b69c-440b2030479a)

## Troubleshooting

\
If your node is not starting properly for some reason, consider opening a WebTTY and checking the logs:\
\
Create a WebTTY [StackOS - WebTTY (external)](https://www.evernote.com/shard/s79/sh/647ab636-068b-946f-9cf5-2c6e9895c0a9/43124974ed3a91d7f41cc255325aba7b)

### Get the name of the presearch-0x... pod

\
kubectl get pods\ <br>

### Show the logs for the pod

`kubectl logs -f presearch-0xYOURETHADDRESS-RANDOM`<br>

### Expect to see something like this

![](https://881106330-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS4taefedlYJ7UrPHAo%2Fuploads%2F54TE5tyEGu1vOP7udSEZ%2Fimage%20\(6\).png?alt=media\&token=3578620a-c52e-4d8b-a64a-da215cbd0cc2)