Anyone Docs
  • 🔷The Documentation For Anyone
    • About
    • FAQ
  • 🔷Relay Setup
    • Get Started
    • Installation and Usage
      • Setting Your Environment
        • Virtualization on Windows
        • Virtualization on macOS
        • Install Ubuntu Server 22.04
        • Server management with SSH in Windows and macOS
      • Install Anon on Linux
      • Install Anon using the apt repository
      • Update Anon and accept terms and conditions
      • Install Anon in Docker
      • Configure SOCKS5 Proxy for Anyone
      • Install Anyone Exit Relay
    • Troubleshooting Common Issues
      • Diagnosing CGNAT and Public IPv4
      • Confirm ORPort Reachability
    • Firewall and Network Configurations
      • Router Port Forwarding
      • Install and Configure Firewall
    • Advanced Configuration and Troubleshooting
      • Configure IPv4 and IPv6
      • DoS mitigation parameters
    • Relay Operator Standards
    • Exit Relay Guidelines
  • 🔷Hardware Setup
    • Setup Guide
    • Description and Specifications
    • Relay Control Panel
      • Home
      • Network Settings
      • Relay Settings
      • Relay Family
      • Proxy Settings BETA
      • Change Password
      • Logs
      • Update
    • Update (Using USB)
    • Update to WEB 3.2.0 (Using UI)
    • Troubleshooting and additional configuration
      • Router Port Forwarding
      • Diagnosing CGNAT and Public IPv4
    • Router Setup
  • 🔷Security and Privacy
    • VPS Hardening
  • 🔷Rewards Dashboard
    • Registering to the Rewards Program
    • Accessing the Rewards Dashboard
    • Using the Rewards Dashboard
    • Rewards Status
  • 🔷Anyone SDK
    • NPM SDK
      • Install NPM Package
      • Run as Library
        • Anon
        • AnonSocksClient
        • AnonControlClient
      • Run from CLI
      • Tutorials
        • Hello Anon World I
        • Hello Anon World II
        • Circuit Control I
        • Circuit Control II
    • Native SDK
      • Anyone Client Releases
      • MAN - Anon Manual
      • Tutorials
        • Anyone Services I
        • Anyone Services II
    • iOS SDK [Beta]
      • Manual Install - CocoaPods
  • 🔷Connect to Anyone
    • Connecting to Linux
      • [Beta] One-Click Linux Setup
    • Connecting to macOS
      • macOS with NPM
      • [Beta] One-Click macOS Setup
    • Connecting to Windows
      • [Beta] One-Click Windows Setup
    • Individual Applications with Anyone
    • Connect Through Hardware
  • 🔷Tokenomics
    • Introduction
    • Token Distribution
      • Token Outflow
      • Other Tokens
    • Relay Rewards
      • Lock Requirement
      • Lock Adjustments
      • Reward Multipliers
    • Additional Roles
      • Authorities and Staking
      • Governance Voting
    • Premium Circuits
      • Premium Circuits
      • Premium Circuits: Metrics
    • Summary
      • Value Accrual Summary
      • Rewards Case Study
    • Appendix
      • M Derivation
      • Risk Equation Derivation
  • 🔷Resources
    • Community and Customer Support
    • Links
    • Token
    • Whitepaper
    • Roadmap
    • API
      • REST
      • [Future] GraphQL
Powered by GitBook
On this page
  • Install the Anyone Client
  • Running the Client
  • Routing System-Wide

Was this helpful?

  1. Connect to Anyone
  2. Connecting to macOS

macOS with NPM

PreviousConnecting to macOSNext[Beta] One-Click macOS Setup

Last updated 7 months ago

Was this helpful?

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 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 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

Completing the Check

Connecting Individual Apps

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

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 to see more cases.

Once the proxy server is enabled, you can return to from Chrome, Brave or Safari and see if your perceived IP has changed!

🔷
https://check.en.anyone.tech
Node.js
Connect Through Hardware
https://check.en.anyone.tech
Individual Applications with Anyone