mirror of
https://github.com/unifi-utilities/unifios-utilities.git
synced 2024-08-30 18:32:21 +00:00
282b9bd3ce
* add missing package version to change log * fix some warnings of lintian during deb build * simplification of the debian package * introduce build script with docker/podman support * use already existing ssh proxy, has the nice effect of not displaying the welcome message * update readme for 1.0.2 * fix missing argument in apt-get autoremove
66 lines
2.2 KiB
Markdown
66 lines
2.2 KiB
Markdown
# UDM / UDMPro Boot Script
|
|
|
|
## Features
|
|
|
|
1. Allows you to run a shell script at S95 anytime your UDM starts / reboots
|
|
1. Persists through reboot and **firmware updates**! It is able to do this because Ubiquiti caches all debian package installs on the UDM in /mnt/data, then re-installs them on every boot
|
|
|
|
## Compatibility
|
|
|
|
1. Should work on any UDM/UDMPro after 1.6.3
|
|
2. Tested and confirmed on 1.6.6, 1.7.0, 1.7.2rc4, 1.7.3rc1, 1.8.0rc7, 1.8.0
|
|
|
|
### Upgrade from earlier way
|
|
|
|
* As long as you didn't change the filenames, installing the deb package is all you need to do. If you want to clean up beforehand anyways....
|
|
|
|
```bash
|
|
rm /etc/init.d/udm.sh
|
|
systemctl disable udmboot
|
|
rm /etc/systemd/system/udmboot.service
|
|
```
|
|
|
|
* [build_deb.sh](build_deb.sh) can be used to build the package by yourself.
|
|
* [dpkg-build-files](dpkg-build-files) contains the sources that debuild uses to build the package if you want to build it yourself / change it
|
|
* by default it uses docker or podman to build the debian package
|
|
* use ```./build_deb.sh build``` to not using a container
|
|
* the resulting package will be in [packages/](packages/)
|
|
|
|
* Built on Ubuntu-20.04 on Windows 10/WSL2
|
|
|
|
## Steps
|
|
|
|
1. Get into the unifios shell on your udm
|
|
|
|
```bash
|
|
unifi-os shell
|
|
```
|
|
|
|
2. Download [udm-boot_1.0.2_all.deb](packages/udm-boot_1.0.2_all.deb) and install it and go back to the UDM
|
|
|
|
```bash
|
|
curl -L https://raw.githubusercontent.com/boostchicken/udm-utilities/master/on-boot-script/packages/udm-boot_1.0.2_all.deb -o udm-boot_1.0.2_all.deb
|
|
dpkg -i udm-boot_1.0.2_all.deb
|
|
exit
|
|
```
|
|
|
|
3. Copy any shell scripts you want to run to /mnt/data/on_boot.d on your UDM (not the unifi-os shell) and make sure they are executable and have the correct shebang (#!/bin/sh)
|
|
|
|
Examples:
|
|
* Start a DNS Container [10-dns.sh](../dns-common/on_boot.d/10-dns.sh)
|
|
* Start wpa_supplicant [on_boot.d/10-wpa_supplicant.sh](examples/udm-files/on_boot.d/10-wpa_supplicant.sh)
|
|
|
|
## Version History
|
|
|
|
### 1.0.2
|
|
|
|
* Some build improvements and more clean installation
|
|
|
|
### 1.0.1
|
|
|
|
* Fully automated install, all that is left is populating /mnt/data/on_boot.d
|
|
|
|
### 1.0.0
|
|
|
|
* First release that persists through firmware
|