/
Getting Started with Arc Server on Mac

Getting Started with Arc Server on Mac

Getting Started with Arc Server on Mac

This guide covers installing and running Arc Server on Mac OS.

Prerequisites

  • TM1 11+ (Planning Analytics 2+) is recommended. Some features work with TM1 10.2.2 but important APIs are only present in TM1 11+.

  • Arc should be installed on the same server as TM1 for full functionality.

Step 1: Download Arc for Mac

  1. Go to code.cubewise.com/arc-download

  2. Download the Mac 64-bit version.

How to check if you need 32 or 64-bit: Go to the Apple Menu → "About this Mac". If you have a Core Duo processor, you have a 32-bit CPU. All other modern processors (Core 2 Duo, Xeon, i3, i5, i7, Apple Silicon) are 64-bit.

Step 2: Start Arc

  1. Unzip the arc.x.x.x_mac64.zip folder.

  2. Copy the arc.app file into your desired folder (e.g. ~/Documents/Arc).

  3. Open Terminal and navigate to the folder:

cd ~/Documents/Arc

  1. Start Arc:

./arc.app &

If you see Server running on port: 7070, Arc has started successfully.

Step 3: Access Arc

Open a browser and go to: https://localhost:7070/

Troubleshooting: Permission Denied

If you see a "Permission denied" error (exit code 126):

chmod a+rwx arc.app

This grants read, write and execute permissions.

Troubleshooting: Mac Security & Privacy Block

If you see "arc.app" cannot be opened because the developer cannot be verified:

  1. Go to System Preferences → Security & Privacy → General.

  2. At the bottom, find the blocked arc-app entry.

  3. Click "Open Anyway".

  4. When prompted again, click Open.

Step 4: Activate a Trial or License

On first run you will need to validate a license. See Trialling and Buying Arc.

Step 5: Connect to TM1

Arc uses the TM1 REST API to connect to instances. Update the adminhost parameter in settings.yml if TM1 is on a different server.

If Arc cannot connect:

  • Verify the TM1 REST API is accessible in your browser.

  • Double-check credentials (CAM Namespace is case-sensitive).