MacOS: Install Worker

Before Starting, Check Your Mac Processor

We currently only support Apple chip processors (M1, M2 and M3). All currently supported processor and video card models can be found here.

To check your Mac processor:

1. On your Mac, click the Apple icon in the top-left corner of the menu bar.
2. Select the About This Mac option.
3. If you see Apple M1 (or higher) in the Chip line, it means you’re using a Mac with an Apple Silicon CPU.

Go to cloud.io.net

If you have not yet created an account, Creating an account on io.net is currently available only through X (Twitter), Apple ID or Google. Simply click on the "Sign Up" button and select either X, Apple ID, Worldcoin or Google to proceed with account creation.

1. From IO Elements Navigate to Worker Section

IO Elements serves as your new control panel for navigating the service efficiently. Click on IO Worker to delve deeper into its functionalities and features.

2. Use "Connect New Worker" Button to Open the Wizard

If Workers have not yet been added, you can use the central button. If the screen is full of information, find the same button in the upper right corner

3. Name Your Device

Click the "Pencil" icon to open the popup for editing the device name. 



Please add a unique name for your device.
An ideal format would be something like this: 
My-Test-Device

4. Select MacOS Operating System “OS”

Choose the Operating System “OS” of your device from MacOS, Windows or Ubuntu.

5. Prerequisites for Mac

Download and install Docker Desktop for MacOS by following the link.

📘

It has been confirmed that some users limit the amount of system resources that IO Worker can access when performing compute verifications. Many users do not set the proper amount of device level resources available for the Docker engine. Many have used default settings or restricted the Worker’s RAM access to 8GB or lower. This would significantly impact the device capability in passing PoW. This is mostly common among Mac devices.

👍

To install Docker on MacOS computers, refer to the "Installing Docker on MacOS" instructions.

6. Download and Launch IO Binary

IO Binary is a compiled executable file used to perform computational tasks and manage system operations. It is crucial for the smooth operation of the platform as it handles essential functions directly related to the performance and reliability of the computational resources.

🚧

Do not modify or run code directly in io.net’s docker containers. This may disqualify your device from earning block rewards or being hired. If you have suggestions or ideas for custom code in our Docker containers, contact customer support to suggest them.

Follow the steps below to download and launch the IO binary:

1. Open the 
Terminal through Launchpad

   Terminal is a tool on your computer that lets you type in commands to tell the computer what to do. Instead of clicking on things with a mouse, you write instructions, and the computer follows them. It's like talking directly to your computer using text.

   Click the Launchpad icon in the Dock, start typing "Terminal" in the search field, then click the Terminal icon:

   

2. Download the IO Binary for MacOS using the following link in the Terminal:

   curl -L https://github.com/ionet-official/io_launch_binaries/raw/main/io_net_launch_binary_mac -o io_net_launch_binary_mac
   

3. Grant permissions to the new IO Binary with this command:

   chmod +x io_net_launch_binary_mac
   

   

4. Copy generated the IO Binary address provided in the wizard and past it into Terminal to run further:

   ./io_net_launch_binary_mac
   

   📘

   To disable sleep mode for a device, pass the --disable_sleep_mode=true argument at the end of the command line.

   ./io_net_launch_binary_mac --disable_sleep_mode=true
   

   You can find more additional arguments to use with the IO Binary command here.

   

7. Authorize Your New Device

The IO Binary may prompt you to authorize your new device.

📘

Remember, you have 3+ minutes to complete the authorization of the device. If you miss it, rerun the code again.

You can do this in two ways:

1. Copy the Link from the Terminal:

   

   Paste it into your browser and confirm the action. After confirmation, the system will prompt you to log in.

   

2. Copy the Code from the Terminal:

   

   Enter this code on the page https://auth0.io.solutions/activate to authorize the device. You will be prompted to log in.

   

📘

Onboard Multiple Devices by Bypassing Interactive Authentication

To onboard a new device, use the following command with the --token flag:

./io_net_launch_binary_mac --token your-token-value

This will allow you to bypass the interactive authentication process.

8. Remove previously installed Docker containers

IO Binary will ask you questions related to previously installed Docker Containers. To continue the installation of IO Worker, you must agree to remove all old containers. To proceed enter Yes.

9. Wait for Worker Connection to Complete

IO Binary will install all additional containers and images for your Docker. The process may take some time to complete as it installs additional packages for Docker. Please allow the installation process to finish.

Afterward, return to the browser to complete the installation.

You may need to wait for up to 10 minutes while the device checks and connects to the IO Ecosystem. If it doesn't connect, contact customer support by logging into your IO.Net account.

🚧

Please disable power-saving mode when running your devices on IO Net. Power-saving mode can impair device performance, potentially leading to failure in PoW or being classified as not providing adequate computing power.

Congratulations on Successfully Setting up Your First Worker.

Now that your Worker has been successfully created and is running, you can track its status on the Workers page.

📘

If you're having trouble installing the Worker, please refer to our MacOS Worker troubleshooting guide or the general Worker troubleshooting guide. If the issue persists or you need further assistance, feel free to open a support ticket by logging into your IO.Net account and submitting a ticket!

🚧

Be aware that you will be installing a 20GB size container. This contains all the packages needed to serve AI/ML apps. Everything happens inside the container, nothing within the container can access your filesystem.