Phala Network Docs
  • Home
    • πŸ‘ΎPhala Network Docs
  • Overview
    • βš–οΈPhala Network
      • πŸ’ŽPhala Cloud
      • πŸ₯·Dstack
      • πŸ”GPU TEE
    • πŸ’ŽPHA Token
      • πŸͺ™Introduction
      • πŸ‘Delegation
        • Delegate to StakePool
        • What is Vault
        • What is Share
        • WrappedBalances & W-PHA
        • Examples of Delegation
        • Use Phala App to Delegate
        • Estimate Your Reward
      • πŸ—³οΈGovernance
        • Governance Mechanism
        • Join the Council
        • Voting for Councillors
        • Apply for Project Funding
        • Phala Treasury
        • Phala Governance
        • Setting Up an Account Identity
  • Phala Cloud
    • πŸš€Getting Started
      • Sign-up for Cloud Account
      • Start from Cloud UI
      • Start from Cloud CLI
      • Start from Template
    • 🟧Launch an Eliza Agent
    • πŸ“¦Create CVM
      • Create CVM with Docker Compose
      • Create CVM with Private Docker Image
      • Set Secure Environment Variables
      • Access Your Applications
      • Setting Up Custom Domain
      • Debug Your Application
      • Deployment Cheat Sheet
    • βš™οΈCVM Management
      • Upgrade Application
      • Resize Resources
      • Check Logs
      • Private Log Viewer
    • πŸ”„Deploy Docker App in TEE
      • Expose Service Port
      • Generate RA Report
      • Access Database
      • Create Crypto Wallet
    • πŸ›³οΈSetup a CI/CD Pipeline
    • πŸ› οΈPhala Cloud CLI Reference
      • phala
        • auth
        • cvms
        • docker
        • simulator
    • Production Checklist
    • ❓FAQs
    • πŸ”Troubleshooting
    • πŸ“–Glossary
    • πŸ“‹References
    • πŸ”’Use Cases
      • TEE with AI
      • TEE with FHE and MPC
      • TEE with ZK and ZKrollup
  • Dstack
    • Overview
    • Getting Started
    • Hardware Requirements
    • Design Documents
      • Decentralized Root-of-Trust
      • Key Management Protocol
      • Zero Trust HTTPs (TLS)
    • Acknowledgement
  • LLM in GPU TEE
    • πŸ‘©β€πŸ’»Host LLM in GPU TEE
    • πŸ”GPU TEE Inference API
    • 🏎️GPU TEE Benchmark
  • Tech Specs
    • ⛓️Blockchain
      • Blockchain Entities
      • Cluster of Workers
      • Secret Key Hierarchy
  • References
    • πŸ”Setting Up a Wallet on Phala
      • Acquiring PHA
    • πŸŒ‰SubBridge
      • Cross-chain Transfer
      • Supported Assets
      • Asset Integration Guide
      • Technical Details
    • πŸ‘·Community Builders
    • 🀹Hackathon Guides
      • ETHGlobal Singapore
      • ETHGlobal San Francisco
      • ETHGlobal Bangkok
    • 🀯Advanced Topics
      • Cross Chain Solutions
      • System Contract and Drivers
      • Run Local Testnet
      • SideVM
    • πŸ†˜Support
      • Available Phala Chains
      • Resource Limits
      • Transaction Costs
      • Compatibility Matrix
      • Block Explorers
      • Faucet
    • ⁉️FAQ
  • Compute Providers
    • πŸ™ƒBasic Info
      • Introduction
      • Gemini Tokenomics (Worker Rewards)
      • Budget balancer
      • Staking Mechanism
      • Requirements in Phala
      • Confidence Level & SGX Function
      • Rent Hardware
      • Error Summary
    • 🦿Run Workers on Phala
      • Solo Worker Deployment
      • PRBv3 Deployment
      • Using PRBv3 UI
      • PRB Worker Deployment
      • Switch Workers from Solo to PRB Mode
      • Headers-cache deployment
      • Archive node deployment
    • πŸ›‘οΈGatekeeper
      • Collator
      • Gatekeeper
  • Web Directory
    • Discord
    • GitHub
    • Twitter
    • YouTube
    • Forum
    • Medium
    • Telegram
  • Legacy
    • Information
    • βš’οΈPhala SDK
    • πŸ‘¨β€πŸš€Builders Program
    • πŸ₯·AI Agent Contract
      • WapoJS Functions
      • Phala Agent Gateway
  • AI Agent Contract (Legacy)
    • πŸ‘©β€πŸ’»Getting Started
      • Build Your First AI Agent Contract
      • Build An Agent to Transact Onchain
      • Build Your AI Agent Contract with OpenAI
      • Build Your AI Agent Contract with LangChain
      • Integrate with 3rd Party API with HTTP Request
      • Run a Local Testnet With Docker
      • AI Agent Contract Templates
    • πŸ§™β€β™‚οΈExamples
      • Create a Weather Agent w/ Function Calling
    • ⛓️Supported Chains
    • FAQ
  • Agent Wars (Legacy)
    • πŸ“œIntroduction
    • πŸ’ΈTokenomics
    • ▢️Getting Started
      • Wallet Setup & Get PHA
      • Buy and Sell Keys
    • πŸ§‘β€πŸ«Tutorial
Powered by GitBook
LogoLogo

Participate

  • Compute Providers
  • Node
  • Community
  • About Us

Resources

  • Technical Whitepaper
  • Token Economics
  • Docs
  • GitHub

More

  • Testnet
  • Explorer
  • Careers
  • Responsible Disclosure

COPYRIGHT Β© 2024 PHALA.LTD ALL RIGHTS RESERVED. May Phala be with you!

On this page
  • Quick Links
  • General
  • Investigating the Issue
  • < 3 running containers
  • Advanced Troubleshooting
  • Peer Connectivity
  • Driver Issues
  • DCAP driver Installation
  • Khala Node Stops Synching
  • Deleting the Mining Scripts

Was this helpful?

Edit on GitHub
  1. Compute Providers
  2. Run Workers on Khala - Archived

Troubleshooting - Archived

Last updated 21 days ago

Was this helpful?

Quick Links

| | | |

πŸ‘‡ You can also join our Discord or Telegram worker group to discuss your issue. πŸ‘‡

General

Most symptoms are solved by restarting your node. If you experience issues running your node, try stopping the node by:

sudo phala stop

And attempt a restart with

sudo phala start

If you still have issues attempt to .

Investigating the Issue

Get an overview of your worker’s status first.

sudo phala status

In case your node is stuck, a typical scenario would look like the following:

(image showing stuck node on the worker)

Now check the status of the node again.

If the local node block height is empty first, check if all required containers are running.

sudo docker ps

You should have three containers running as shown in this example:

(image showing the worker node’s running docker containers)

To get the most recent logs of each container, you may execute:

docker logs <container_ID/container_name> -n 100 -f

Note that <container_ID/container_name> must be replaced with the container you wish the receive the logs from. In the example above the container_ID is 8dc34f63861e and container_name would be phala-pherry.

If you attempt to post on the phala forum and do not know where the issue lies, please post the logs of all three docker containers. Copy-paste the container logs from the terminal into the forum post.

< 3 running containers

If a container is missing (<3 are running), you may attempt to restart it separately with the respective commands below.

Use the applicable command to restart your missing container.

sudo phala start node
sudo phala start pruntime
sudo phala start pherry

Advanced Troubleshooting

In some cases, it might be beter to reinstall the mining script. To do this, first uninstall the script:

sudo phala uninstall

And delete the mining script repository by executing:

rm -rf $HOME/solo-mining-scripts-main

Now you may reinstall the mining script.

sudo apt update && sudo apt upgrade -y && sudo apt autoremove -y
sudo apt install wget unzip
cd ~
wget https://github.com/Phala-Network/solo-mining-scripts/archive/refs/heads/main.zip
unzip main.zip
rm -r main.zip #cleaning up the installation
cd solo-mining-scripts-main/ #note this depends on your current directory
sudo ./phala.sh install

Peer Connectivity

Some users running nodes may find their nodes are struggling to connect to peers, which causes nodes to be dropped from the network. You can check your node connections through executing:

sudo docker logs -f phala-node

For an optimal setup, you should have between 40 and 50 peers.

If you have insufficient peers do the following:

  • Check your firewall settings

  • Ensure there are no NAT or Policy-based filters

Driver Issues

DCAP driver Installation

ℹ️ The most common issue is that your motherboard may not support a DCAP driver. In this case, the script cannot automatically install the isgx driver and results in the following error message.

(image of the terminal showing the DCAP driver error message)

In this case, prior to running sudo phala start, you need to manually install the isgx driver:

sudo phala install isgx

Khala Node Stops Synching

If the synchronization still fails, you may try to delete the khala chain database on your worker’s node. It is located in /var/khala-dev-node/chains/khala.

(image showing the khala blockchain files of the worker node)

It is located in /var/khala-dev-node/chains/khala.

First, stop your node with:

sudo phala stop

To delete the khala blockchain database on your node, execute the following commands:

rm -rf /var/khala-dev-node/chains/khala

To delete the Kusama blockchain , run:

rm -rf /var/khala-dev-node/chains/polkadot

Deleting the Mining Scripts

If you encounter any issues uninstalling the mining scripts and all dependencies except the drivers, you may delete them by executing the following commands:

sudo rm -r /opt/phala
sudo rm -r ~/solo-mining-scripts-main
sudo rm ~/main.zip

With the symptom in the scenario above, the right method to solve the issue would be restarting the node container only, with the commands mentioned , and restarting the containers.

You may now .

Feel free to read for more information if you are curious about the root causes. Also, do not hesitate to look for existing before posing your issue if you are stuck.

If the Khala Chain stops synching and is stuck at a specific block and does not continue to sync, we advise you first to .

You can to redownload and reinstall the new phala mining scripts.

πŸƒβ€β™€οΈ
General
Investigate
Confidence Level
Stuck Worker
Forum
Discord
Telegram
Forum
GitHub
update the script
NAT
Phala forum posts
follow this tutorial
here
restart your node
restart your node