Quick LinksGeneral Investigate Confidence Level Stuck Worker Forum
👇 You can also join our Discord or Telegram worker group to discuss your issue. 👇
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 update the script.
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:
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 here, and restarting the containers.
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
<container_ID/container_name> must be replaced with the container you wish the receive the logs from. In the example above the
container_name would be
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
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
You may now restart your node.
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
Feel free to read NAT for more information if you are curious about the root causes. Also, do not hesitate to look for existing Phala forum posts before posing your issue if you are stuck.
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
sudo phala install isgx
Khala Node Stops Synching
If the Khala Chain stops synching and is stuck at a specific block and does not continue to sync, we advise you first to restart your node.
If the synchronization still fails, you may try to delete the khala chain database on your worker’s node.
It is located in
(image showing the khala blockchain files of the worker node)
It is located in
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 unistalling 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
You can follow this tutorial to redownload and reinstall the new phala mining scripts.