Repolode
chentao1006

chentao1006/FluxMonitor

A macOS system monitoring and remote control dashboard for running a Mac as a server, with mobile clients for iOS and Android.

Stars
97
Forks
9
Open issues
0
Last commit
29 days ago

What is it?

Flux Monitor is a dashboard for keeping an eye on a Mac that runs as a home server or always-on machine. It shows CPU, memory, disk and network usage, lets you run terminal commands, and provides views for processes, listening ports, system logs and configuration files.

Beyond basic monitoring, it covers common server administration tasks: it can inspect which process owns a port and release it, manage macOS LaunchAgents and LaunchDaemons, and manage Docker containers and images. Nginx sites and global configuration can also be edited from the dashboard. Each module can be switched on or off in config.json.

The macOS launcher runs the monitor service from the menu bar, and iOS and Android apps connect to it remotely. An optional OpenAI-compatible AI assistant can help parse logs, audit configuration and suggest troubleshooting steps, and an built-in InstaTunnel option exposes the local dashboard to the internet.

Key features

  • 01Shows CPU, memory, disk and network usage, and runs terminal commands.
  • 02Lists processes and ports, and releases ports held by a process.
  • 03Browses system logs and edits system configuration files.
  • 04Manages macOS LaunchAgents, LaunchDaemons, Docker containers and images, and Nginx sites.
  • 05Optional AI assistant for log parsing and configuration auditing via an OpenAI API key.
  • 06Native iOS and Android clients for remote monitoring.

Use cases

  • Keeping an eye on a Mac used as a home or lab server.
  • Finding which process is holding a port and freeing it without using the terminal.
  • Managing Docker containers and Nginx configuration on a Mac host.
  • Checking system status and running commands from a phone while away.

Quick start

  1. 1

    Install the macOS launcher with Homebrew

    brew install --cask chentao1006/tap/flux-monitor
  2. 2

    Open Flux Monitor from Applications to start the dashboard

  3. 3

    Optionally install the iOS or Android client from the app stores

Things to know

  • The monitored host must be a Mac, and the launcher is macOS-only.
  • The optional AI assistant requires your own OpenAI API key.

In collections

Topics

FAQ

What is FluxMonitor?
A macOS system monitoring and remote control dashboard for running a Mac as a server, with mobile clients for iOS and Android. Flux Monitor is a dashboard for keeping an eye on a Mac that runs as a home server or always-on machine. It shows CPU, memory, disk and network usage, lets you run terminal commands, and provides views for processes, listening ports, system logs and configuration files.
Is FluxMonitor free to use? What license does it have?
FluxMonitor is open source under the MIT license. Check the license terms before using it in commercial products.
Is FluxMonitor still maintained?
Actively maintained. The last commit to FluxMonitor was on Sep 23, 2026.
What can I use FluxMonitor for?
Keeping an eye on a Mac used as a home or lab server. Finding which process is holding a port and freeing it without using the terminal. Managing Docker containers and Nginx configuration on a Mac host. Checking system status and running commands from a phone while away.
How do I install FluxMonitor?
Install the macOS launcher with Homebrew: brew install --cask chentao1006/tap/flux-monitor Open Flux Monitor from Applications to start the dashboard Optionally install the iOS or Android client from the app stores
Where can I get FluxMonitor?
The source code and installation instructions are on GitHub: https://github.com/chentao1006/FluxMonitor

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects