{"id":21714122,"url":"https://github.com/arcxteam/nexus-node","last_synced_at":"2025-10-19T22:23:33.922Z","repository":{"id":259653432,"uuid":"879136000","full_name":"arcxteam/nexus-node","owner":"arcxteam","description":"Nexus is ZkVM a Modular Verifiable Internet. A Complete Guide - Run Nexus node as Prover Network.","archived":false,"fork":false,"pushed_at":"2025-02-20T18:16:38.000Z","size":93,"stargazers_count":8,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-12T19:09:00.162Z","etag":null,"topics":["nexus","nexus-cli","nexus-node","nexus-scripts","nexuslabs","node-guide","node-runtime","prover","rust-lang","supercomputer","testnet-node","zkevm","zkproof","zkproof-prover","zkvm"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/arcxteam.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-27T04:43:44.000Z","updated_at":"2025-03-08T04:49:05.000Z","dependencies_parsed_at":"2024-12-16T07:32:16.581Z","dependency_job_id":"925f6d66-7bef-4cb9-a288-8b8b9741eaf6","html_url":"https://github.com/arcxteam/nexus-node","commit_stats":null,"previous_names":["arcxteam/nexus-node"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arcxteam%2Fnexus-node","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arcxteam%2Fnexus-node/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arcxteam%2Fnexus-node/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arcxteam%2Fnexus-node/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/arcxteam","download_url":"https://codeload.github.com/arcxteam/nexus-node/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248618277,"owners_count":21134200,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["nexus","nexus-cli","nexus-node","nexus-scripts","nexuslabs","node-guide","node-runtime","prover","rust-lang","supercomputer","testnet-node","zkevm","zkproof","zkproof-prover","zkvm"],"created_at":"2024-11-26T00:31:51.332Z","updated_at":"2025-10-19T22:23:33.909Z","avatar_url":"https://github.com/arcxteam.png","language":"Shell","readme":"![com-webp-to-png-converter](https://github.com/user-attachments/assets/0fb7877d-8638-49a3-8a3f-670f9de617d9)\n\n# A Complete Guide Nexus Testnet Node - Running on Docker (Non-Interactive)\n\nThe Nexus Labs zkVM (zero-knowledge virtual machine) is a modular verifiable internet, as extensible, open-source, highly-parallelized, prover-optimized, contributor-friendly, zkVM written in Rust, focused on performance and security. Read this step to runnig Nexus node as Prover Network.\n\n[![Release Version](https://img.shields.io/github/v/release/nexus-xyz/nexus-cli.svg)](https://github.com/nexus-xyz/nexus-cli/releases)\n\n\u003e 2024, 10 Dec for CLI prover-id binding ![Confirm](https://img.shields.io/badge/Testnet_1-END_-red)\n\n\u003e 2025, 19 Feb CLI Run for ![Confirm](https://img.shields.io/badge/Testnet_2-END_-red)\n\n\u003e **Update**; 2025, 23 JUNE CLI Run for ![Confirm](https://img.shields.io/badge/Testnet_3-ONGOING_-brightgreen)\n\n## Here We Go...Gas!!!\n`Is there incentivized?` ![Confirm](https://img.shields.io/badge/Confirm-yes-brightgreen)\n\n\u003e [!IMPORTANT]\n\u003e What incentives do you offer for contributing to the network? At this time, contributors receive recognition through public leaderboards. Nexus may implement additional incentives in a future release. Read here https://nexus.xyz/network#network-faqs\n\n**There mentioned in FAQs; As following categories of contributions and this incentive pools are indicated on faqs.**\n\n![N-E-X-U-S-10-27-2024_12_46_AM](https://github.com/user-attachments/assets/8f195829-249f-4528-862d-e94bcb55d4df)\n\n| Incentivized Activity             | Allocation Token |\n|-----------------------------------|---------------|\n| Running Nexus Prover Node         | xxxxx (TBA) |\n| Testnetwork                       | xxxxx (TBA) |\n\n## 1. Preparation Nexus Node\n**1. Hardware requirements** \n\n`In order to ran Nexus prover node as CLI, need a Linux server (VPS) with the minimum recommended hardware`\n| Requirement                      | Details                                          |\n|-----------------------------------|------------------------------------------------|\n| RAM                               | 4 GB                                            |\n| CPU/vCPU                          | 2-4 Cores                                        |\n| Storage Space                     | 50-100 GB                                      |\n| Supported OS                      | Ubuntu 20.04, 22.04, 24.04 LTS                 |\n\n**2. Hardware requirements**\n\n`In order to ran Nexus prover node as BROWSER, need a device`\n| Requirement                      | Details                                         |\n|-----------------------------------|------------------------------------------------|\n| Internet                          | Stable Connection                            |\n| Portable Devices                  | Hand/mobile phones, PC/Laptop/Netbooks, Tablet | \n| Web Browser                       | Chrome, Firefox, Safari, Opera, Brave, Edge, UC/Kiwi etc.. |\n\n**3. Configuration Nexus prover node**\n\nIf you don't have these dependencies already, install them first.\n\n```\nsudo apt update \u0026\u0026 sudo apt upgrade -y \nsudo apt install build-essential pkg-config libssl-dev git-all protobuf-compiler\n```\n## 2. Start Install using Docker\n\n**1. Auto Installing by Docker**\n\n```bash\ngit clone https://github.com/arcxteam/nexus-node.git\ncd nexus-node\n```\n\n**2. Manual Installing by CLI**\n\n```\ncurl https://cli.nexus.xyz/ | sh\n```\n\n\u003e If you do not already have Rust, you will be prompted to install it.\n\n## 3. Update First Setup \n\n**1. Update CLI for Binding a Wallet Address**\n\nIf you have runtime at **previous \u0026 run now**, please binding your **node-id** for manual without auto installer skrip `nexus.sh` above. so the step here\n\n- Go to https://app.nexus.xyz/nodes\n- Open and wait the dashboard showing all and go section `add node` \u003e `add CLI node` \u003e check `copy` and done\n- Open your ssh-vps-terminal, add/input your **WALLET_ADDRESS** and use command to enter\n```\necho \"WALLET_ADDRESS=your-wallet\" \u003e\u003e /root/nexus-node/.env\n```\n\u003e For example \n```diff\n- echo \"WALLET_ADDRESS=0x123456789\" \u003e\u003e /root/nexus-node/.env\n```\n\n**2. After running check logging**\n\n```\ndocker compose logs -f nexus-docker\n```\n- or in the root\n```\ndocker logs -f nexus-docker\n```\n\n**3. Running on Multiple NODE-ID**\n\n- This will Run and create\n- Replace **WALLET_ADDRESS**\n- Rename for next wallet address -\u003e **WALLET_ADDRESS_1** more multiple 3,4,5....\n\n- ### If the container is running, you will see the status from the Dashboard nexus slow this processing\n\n\u003e Still wait, this having for syncing on website, check `Nexus Point` on section page.....\n\n![image](https://github.com/user-attachments/assets/a2d5e515-df98-4701-93aa-5df3ceb26c57)\n\n![Desktop-screenshot-02-21-2025_12_57_AM](https://github.com/user-attachments/assets/ea0abe49-3f66-4c98-8d30-20443ca0cef3)\n\n**2. Upgrade version for network-api**\n\nlogs: If have facing issue cargo/cycles etc `Proof sent! You proved at 0 Hz` try `git tag -l` for the latest Api Network https://github.com/nexus-xyz/network-api/releases/\n\n```\ndocker ps -a --filter \"name=nexus-docker-\" --format \"{{.Names}}\" | xargs -r docker rm -f \u0026\u0026 docker images --filter \"reference=nexus-docker-*\" --format \"{{.ID}}\" | xargs -r docker rmi -f \u0026\u0026 rm -rf /root/nexus-data/nexus-docker-* \u0026\u0026 cd /root/nexus \u0026\u0026 chmod +x nexus.sh \u0026\u0026 ./nexus.sh node-id-1.txt\n```\n\n## 4. Usefull Commands\n\n**1. Based-on ran Nexus Labs node**\n\n\n`Checking the status service and resources`\n\n- docker images | grep nexus-docker\n- docker ps -a\n- docker stats\n\n`Check Version or error`\n\n```\nsource /root/.bashrc\nsource /root/.profile\nnexus-network --version\n```\n**2. Important Note** \n\n- Delete all Nexus Node running service\n\n```\ndocker rmi -f $(docker images --filter \"reference=nexus-docker-*\" --format \"{{.ID}}\")\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farcxteam%2Fnexus-node","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farcxteam%2Fnexus-node","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farcxteam%2Fnexus-node/lists"}