macOS with NPM

This guide will explain how to use the start the anyone-client and setup macOS to automatically route all compatible apps through the network, including browsers, streaming and more. We can do this using the Anyone SDK, which is built for creating private applications, but also works for individual use!

Primer: Test if you are on Anyone

You can visit the URL https://check.en.anyone.tech to check that you aren't already connected to the Anyone network a different way

Install the Anyone Client

The simplest way to install anyone is through npm. If you already have npm, you can skip the collapsible window below

Installing npm

You can install easily by following the macOS guide on the Node.js website. The steps are replicated here, to be pasted and run on the Terminal app on your Mac.

1. Install nvm

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash

1. Use nvm to install Node.js 20

nvm install 20

1. Verify that you have installed Node.js and npm by ensuring you get a version code for each of these commands

node -v
npm -v

Once you have npm, simply install like below from the Terminal app

npm install @anyone-protocol/anyone-client 

Running the Client

Once installed, you can start the anyone-client with the default configuration from the Terminal:

npx anyone-client

This will show a few setup messages, ending with

Optional: Changing from the default configuration

If you have a specific use-case, or have issues with connecting in the subsequent steps, you can set

-s Set the SocksPort (default: 9050)

-c Set the ControlPort (default: 9051, use 0 to disable)

-o Set the OrPort (default: 9001)

-v Enable verbose mode for full client logs

-f Set the path to custom anonrc config file

-b Set the path to custom anon binary (To use preinstalled one)

Routing System-Wide

To route system-wide, go to System Preferences and navigate to the Proxies window - the simplest way is to search for it from the searchbar. This will open a pop-up like below:

From there, enable the Socks proxy option and put in the following options:

Server: 127.0.0.1
Port: 9050

If you are not running anyone-client on your macOS machine (for example, running it on the hardware or another local server), the server IP will be different. Head to Connect Through Hardware to see more cases.

Completing the Check

Once the proxy server is enabled, you can return to https://check.en.anyone.tech from Chrome, Brave or Safari and see if your perceived IP has changed!

Connecting Individual Apps

If you'd instead like to connect individual apps, instead of configuring all applicable programs, see below!

Individual Applications with Anyone