---
updatedAt: 2025-05-20T03:18:01.000Z
agentTools:
  projectIndex: https://doc.overops.com/llms.txt
---

# OverOps for Java on macOS

This article walks you through the process of installing OverOps on your laptop or local PC Java application using macOS.

> 🚧 Important
>
> The macOS Collector with Java Micro-Agent are only supported as local installations and are **not** intended for production installation.
>
> This installer has been provided to allow for quick demo purposes installation, for example on your personal laptop. The macOS version does not support installing the Collector on a separate machine.

Here is a window describing the process

<Embed url="https://www.youtube.com/watch?v=bJNdUkUhna0&ab_channel=OverOps" title="How to install OverOps on a Mac" favicon="https://www.youtube.com/s/desktop/2498be25/img/favicon.ico" image="http://i.ytimg.com/vi/bJNdUkUhna0/hqdefault.jpg" provider="youtube.com" href="https://www.youtube.com/watch?v=bJNdUkUhna0&ab_channel=OverOps" html="%3Ciframe%20class%3D%22embedly-embed%22%20src%3D%22%2F%2Fcdn.embedly.com%2Fwidgets%2Fmedia.html%3Fsrc%3Dhttps%253A%252F%252Fwww.youtube.com%252Fembed%252FbJNdUkUhna0%26display_name%3DYouTube%26url%3Dhttps%253A%252F%252Fwww.youtube.com%252Fwatch%253Fv%253DbJNdUkUhna0%26image%3Dhttp%253A%252F%252Fi.ytimg.com%252Fvi%252FbJNdUkUhna0%252Fhqdefault.jpg%26key%3Df2aa6fc3595946d0afc3d76cbbd25dc3%26type%3Dtext%252Fhtml%26schema%3Dyoutube%22%20width%3D%22854%22%20height%3D%22480%22%20scrolling%3D%22no%22%20title%3D%22YouTube%20embed%22%20frameborder%3D%220%22%20allow%3D%22autoplay%3B%20fullscreen%22%20allowfullscreen%3D%22true%22%3E%3C%2Fiframe%3E" />

### Prerequisites

* macOS 10.7 and above required
* OverOps for macOS requires the Oracle/OpenJDK JRE to run. Apple’s Java plug-in is **not** supported.\
  See [OverOps Installation Prerequisites](https://doc.overops.com/docs/overops-installation-requirements) for additional details.

### Install the Collector and the Agent (One-step Install)

1. Go to this [link](https://app.takipi.com/app/download?t=dmg) to download and run the OverOps macOS installer.
2. Enter your installation key (aka installation secret key), which you can find in your welcome email or in app.overops.com in the Environments window  (go to **Settings** in the top navigation tab and then click **Manage Environments**).

![1240](https://files.readme.io/a90e6fd-shot-mac-install.png "shot-mac-install.png")

3. If your server is running behind a proxy server, enter its IP address. You'll need to click the **Go Back** button until you see the Proxy Settings.

The Collector is started automatically after installation.

#### To stop the local collector

Use `sudo launchctl unload /Library/LaunchDaemons/com.takipi.service.plist`

#### To start / restart the local collector

Use `sudo launchctl load /Library/LaunchDaemons/com.takipi.service.plist`

### Attach the Micro-Agent to Your Application

1. Follow the steps to [attach the Java Micro-Agent](https://doc.overops.com/docs/attach-agent-and-test-installation). After the connection is established, the application status will show that OverOps is active.
2. Verify that your application throws exceptions.