animegasan/mikhmon repository overview

MikroTik Hotspot Monitor (Mikhmon) is a web-based application (MikroTik API class PHP) to help manage the Mikrotik management system, especially hotspot management.

The image build on Alpine Linux⁠, App Mikhmon from Laksamadi Guko⁠ and Dockerfile inspiration from Trafex⁠.

⁠Supported Architectures

We utilise the docker manifest for multi-platform awareness. Simply pulling animegasan/mikhmon:latest should retrieve the correct image for your arch, but you can also pull specific arch images via tags.

The architectures supported by this image are:

Note : For Cloudflare Zero Trust users, recommended to use Mikhmon version 3 with tags animegasan/mikhmon:v3-latest

⁠Usage

Here are some example snippets to help you get started creating a container.

⁠docker-compose (recommended)

---
version: "2.1"
services:
  mikhmon:
    image: animegasan/mikhmon:latest
    container_name: mikhmon
    ports:
      - 8080:80
    restart: unless-stopped

⁠docker cli

docker run -d \
  --name=mikhmon \
  -p 8080:80 \
  --restart unless-stopped \
  animegasan/mikhmon:latest

⁠Web Interface

Open your web browser and visit the url http://<IP_ADDRESS>:8080 to have access to the Mikhmon's web interface.

• Default username: mikhmon
• Default password: 1234

It's highly recommended to change the default access credentials on first start.

⁠Packages

The package used by this image are:

• nginx
• php
• php81-fpm
• php81-gd
• php81-mbstring
• php81-mysqli
• php81-session
• supervisor

⁠Version

⁠Version 4 Beta

• 4-4.2.2:
  • User Profile
    • Fix expired mode notice.
    • Expire date change to mmm/dd/yyyy hh:mm:ss N for notice and mmm/dd/yyyy hh:mm:ss X for remove.
• 4-4.2.1:
  • User Profile
    • Lock Server change to Disable/Enable. So, the hotspot server will be adjusted to the hotspot server where the user is logged in.
• 4-4.2.0:
  • Dashboard
    • Hotspot Active.
    • Hotspot Users.
    • Live Report.
    • Disable/Enable from settings.
    • App log.
    • Hotspot log.
  • Hotspot
    • Users (add & remove user).
    • User Profile (add remove profile).
      • Add Lock Server mode.
      • Lock the server hotspot after login.
    • Active (remove active user).
    • Host.
    • @global filter.
    • Generate Voucher.
  • Log
  • Report (global filter & download CSV and XLS).
  • Template editor.
  • New template format html. (Here for template⁠)

⁠Version 3

• 3-3.20: - Fixed typo script profile on-login. (Please update the user profile of Mikhmon, by opening each user profile, then Save.)

⁠Credit

Tim de Pater⁠, Laksamadi Guko⁠, Hilman Maulana⁠.