https://github.com/looran/ubiquiti_adm
manage Ubiquiti Unifi access-point via SSH
https://github.com/looran/ubiquiti_adm
ssh ubiquiti ubnt unifi
Last synced: 3 months ago
JSON representation
manage Ubiquiti Unifi access-point via SSH
- Host: GitHub
- URL: https://github.com/looran/ubiquiti_adm
- Owner: looran
- License: bsd-2-clause
- Created: 2022-10-14T18:43:08.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2022-10-14T19:01:20.000Z (over 2 years ago)
- Last Synced: 2025-01-12T05:08:13.780Z (5 months ago)
- Topics: ssh, ubiquiti, ubnt, unifi
- Language: Shell
- Homepage:
- Size: 3.91 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## ubiquiti_adm - manage Ubiquiti Unifi access-point via SSH
tested on Ubiquiti Unifi 7.2
2022, Laurent Ghigonis
### Usage
```bash
usage: ./ubiquiti_adm [-v]
action:
system : get system informations
wifi-aps : list wifi access points ssids
wifi-clis : list wifi clients per access point
wifi-start : start one ssid
wifi-start-radio : start wifi radio, enabling all ssids
wifi-stop : stop one ssid
wifi-stop-radio : stop wifi radio, disabling all ssids
ssh : open ssh session
-v : verbose output
SSH_OPTS=-o HostKeyAlgorithms=+ssh-rsa
```
### Example usage
* list SSIDs
```bash
$ ubiquiti_adm 192.168.1.1 wifi-aps
1 ath0 UP Company wireless
2 ath1 UP Company wireless 5G
3 ath2 UP Guest access
```
* list Wifi clients
```bash
$ ubiquiti_adm 192.168.1.1 wifi-clis
"00:11:22:33:44:55", "Company wireless", 149, 6779538491, 5423793449, [
"00:11:22:33:44:00", "192.168.2.11", -76, 2210, 4, 361792, 229603, "pipounette"
"00:11:22:33:44:01", "192.168.2.12", -64, 26483, 8, 212150812, 74231234, "PC-392"
"00:11:22:33:44:56", "Company wireless 5G", 6, 3434642, 2187203, []
"00:11:22:33:44:57", "Guest access", 6, 3434642, 2187203, []
"00:11:22:33:44:02", "192.168.3.11", -64, 93438, 8, 194304983, 93434333, "iphone"
```
* disable one SSID
```bash
$ ubiquiti_adm 192.168.1.1 wifi-stop "Guest access"
```
* disable all radio
```bash
$ ubiquiti_adm 192.168.1.1 wifi-stop-radio
```
### Prerequisites
1. Get SSH access to your Ubiquiti access point, preferably with an ssh key to avoid entering password
2. If you are using active actions such as wifi-start/wifi-stop/wifi-start-radio/wifi-stop-radio, do not connect an management platform such as Unifi Controller / Unifi Console to the network, as they may rollback actions set my ubiquiti_adm
### Installation
```bash
$ sudo make install
```