Viction
  • Getting Started
  • General
    • Overview
    • Viction Blockchain
      • PoSV Consensus
      • Comparison
    • Staking
      • Staking Requirements
      • Staking Rewards
      • How to stake on Viction Wallet
    • Network Information
      • Viction Mainnet
      • Viction Testnet
    • Viction RPC API
  • Smart Contract Development
    • Solidity
      • A Simple Smart Contract
      • Solidity by Example
    • Standards & Specification
      • VRC25 Specification
      • VRC725 Specification
    • IDEs and Tools
      • Remix
      • Ethers.js
      • web3.js
      • thirdweb CLI
    • Deployment & Verification
      • Hardhat
      • Foundry
  • DApp Development
    • Integration
      • Exchange/Wallet integration
      • VRC25 Exchange/Wallet integration
      • Viction Staking Governance
      • VIC ZeroGas
      • VRRF
    • Data and analytics
    • Embedded Wallet (MPC)
    • Walkthrough: Build a Dapp on Viction
      • Setup Environment
      • Write the Smart Contract
      • Interacting with the Dapp in a browser
  • Masternode
    • Requirements
    • Run a Full Node
      • Binary
      • Create a Viction Masternode
      • Tmn
      • Docker
    • Apply Your Node
    • Slashing Mechanism
    • Chain Data Snapshots
    • Troubleshooting
  • Viction Wallet
    • User Guide
      • Authentication
      • How to create a new wallet
      • How to restore a wallet?
      • Wallet settings
      • Send & Receive Tokens
      • Add custom token
      • Manage Tokens
      • Send NFT
      • General settings
    • Developer Guide
    • Privacy Policy
    • Term and Services
  • Viction Bridge
    • Spacegate
    • Arken Bridge
    • Hyperlane
  • Viction Data Availability
    • Viction DA RPC API
    • DA Integration Use cases
      • Simple Guide for Integrating OP Stack Rollup with Viction DA Layer
  • How to
    • How to Connect to Viction Blockchain
      • Coin98 Super Wallet
      • Metamask
      • Ledger
    • How to troubleshoot when the node is up but couldn't begin to sync block
    • How to Vote for Viction Saigon Network Upgrade Proposal
    • How to issue a token via VICIssuer
    • How to verify if a contract has been issued via VICIssuer
    • How to deploy the VRC725 contract
    • How to apply ZeroGas for VRC725 contract
    • How to Migrate Dapps from Ethereum
    • How to register Token or NFT logo on Vicscan
    • How to verify a contract on Vicscan
    • How to confirm a project on Vicscan
    • How to check if a token is gas sponsored on Viction
    • How to verify gas sponsored transactions
    • How to create Telegram Mini Apps
    • How to use VictionSafe (Multisig)
  • FAQ
    • APIs
    • General
      • Viction
      • Ecosystem
      • VIC - Economics
      • Contact & Support
    • Masternodes and Voting
      • Masternodes
      • Voter
    • Products
      • VicScan (Explorer)
      • VicMaster
      • VicStats
      • VicIssuer
        • How to Verify & Publish Contract Source Code on VicScan
      • Viction Wallet
      • Viction Data Availability Network
  • Legal
    • Terms of Use
    • Privacy Policy
  • Whitepaper and Research
  • Archive
    • TOMOE
    • How to Deploy a VRC25 Token on Viction
    • How to deploy an ICO smart contract on Viction
    • How to deploy an NFT token
    • An Example of Building a Dapp on Viction
    • Migrate Ethereum Dapp to Viction
    • TomoMasterDAO
      • Introduction
      • Governance model
        • On-Chain vs Off-Chain Voting
        • Board
        • Proposals
        • Voting and Outcome
      • Tokenomics
      • How to utilize and trade tDAO
      • Proposal guidelines for TomoMasterDAO
    • Old Viction Testnet
    • Deploy on Viction
      • CLI Commands
      • Viction Private Testnet Setup
Powered by GitBook
On this page
  • The node has been running for a long time and couldn't connect to any peer.
  • How to verify if I extract the snapshot correctly.
  1. Masternode

Troubleshooting

Self-help guide to resolve common issues when deploying new node

PreviousChain Data SnapshotsNextViction Wallet

Last updated 3 months ago

The node has been running for a long time and couldn't connect to any peer.

P2P port is not opened

The common cause for this issue is usually related local machine network configuration, in particular the P2P port (default 30303) is not accessible from the internet. To check that P2P is accessible from outsite, you can use any open port checker to help with this. At the time of this writing, a working tool can be used is .

Please note that the node must be running while checking for open port.

If the port is not accessible from outsite, please verify local machine firewall and Cloud provider firewall if any.

NAT param is not provided

Another common cause for the issue is NAT is not provider via command line when starting the node. Somtimes the node itself cannot determine its external IPv4 address, there when it broadcast its enode to boot node, other peers don't know which IP to connect to.

For instance, the IP of VM running the node is 35.212.224.171, the NAT param should be:

--nat extip:35.212.224.173

P2P port running on Docker is different from 30303

Official Viction Docker image prior to v2.4.5 doesn't support custom P2P port out of the box. If you're in this case, please use port 30303 only.

Since Viction v2.4.5, the Docker image have a new environment variable P2P_PORT to change the P2P for node run inside Docker image.

In Docker setup, EXTIP environment variable is strongly recommended to be provided to support NAT configuration for the node.

In both cases, please map the P2P port of Docker image to same port in the host.

For instance, if you want to have P2P port to 20202, it must be mapped to port 20202 of the host. The command line argument for this example will be

docker run -e EXTIP=35.212.224.171 -e P2P_PORT=20202 -p 20202:20202 ...

For instance, the IP of VM running the node is 35.212.224.171, and you want P2P port to be 20202, the Docker command to start the container should have the following params:

-e EXTIP=35.212.224.171 -e P2P_PORT=20202 -p 20202:20202

How to verify if I extract the snapshot correctly.

A common datadir will look like this.

  • keystore: where the account for masternode is stored.

  • tomo/chaindata: CHAIN_DATA.tar.zst will be extracted to this directory.

  • tomox: TOMOX_DATA.tar.zst will be extracted to this directory.

As of December 2024, the size of datadir is follow, so the extract should be like this or higher:

  • Full node: 900 GB

  • Archive node: 3743 GB

https://www.yougetsignal.com/tools/open-ports/