📓Troubleshooting

Solutions for the common issues you might encounter

Q: I can not start installation on MacOS. Reason "unidentified developer".

New packages downloaded on the Mac have to be opened with secondary click.

If you encounter an error like this, please do the following:

1. Navigate to the download folder and select file

2. Use the secondary click (right click on the mouse or tap with two fingers on your trackpad)

3. On the modal view that appears tap the "Open" button

4. Installation will proceed as normal

Q: I installed the Coretex CLI and tried executing a command, but I got a "bad CPU type" error.

You've installed Coretex CLI package intended for the different CPU architecture. For example, if you install the package for the Mac M1 chip on the Mac machine with the Intel CPU, you will get this error. Please double-check the download link and reinstall proper version of the tool.

Q:I am trying to check the node status but I get a "Remote Node Status Error".

Node status command verifies two things, status of your local node and its visibility on the Coretex Platform. Make sure the following is true:

1. Your machine is online and can connect to the internet

2. Your node and user are configured properly. You can inspect the configurations with:

coretex config --node
coretex config --user

Q: I have several issues related to node and dataset management.

You're probably using an older version of the Coretex CLI tool. To get the most recent Coretex features, download the latest version on your machine. You can always check the version that you are currently using by executing this command in the terminal:

coretex --version

The result of the executed command. The version of the Coretex CLI tool will appear on the line below the executed command.

Please always check your internet connection and the syntax of the command. Misspelling just one letter or entering wrong number of dashes will result in command failure.

Q: I am trying to update the node or user configuration but typing "y" only exits the command.

Typing the lowercase letter "y" will break updating process.

This process is case-sensitive, so if you want to proceed with the updating configuration for the user or node, you have to confirm it with the uppercase letter "Y" (yes) on your keyboard.

Q: I have configured node to run using GPU image but I am unable to get it started.

In order to start the node, first make sure you have Docker installed and running on your machine. Node uses nvidia graphics cards. This means several additional steps might be required to run the node with GPU configuration.

Make sure you have nvidia-container-toolkit installed, and nvidia-ctk runtime configured for Docker. Follow the official nvidia installation guide to configure these packages on your machine.

If your version of Docker does not support docker-compose command, make sure to have it installed as separate package:

curl -s https://api.github.com/repos/docker/compose/releases/latest | grep browser_download_url | grep docker-compose-linux-x86_64 | cut -d '"' -f 4 | wget -qi -
chmod +x docker-compose-linux-x86_64
sudo mv docker-compose-linux-x86_64 /usr/local/bin/docker-compose

Replace docker-compose-linux-x86_64 with the appropriate version for your system.