| commit | author | age | ||
| f0f4ec | 1 | # mFi |
| JK | 2 | |
| 3 | This is a Docker image of mFi Controller | |
| 4 | (https://www.ubnt.com/download/mfi/default/default/mfiunixzip) | |
| 5 | based on `openjdk:7-jre-slim`. | |
| 6 | ||
| 7 | ## Disk space requirements | |
| 8 | ||
| 9 | mFi requires significant amount of storage - 3 GB just for starters. | |
| 10 | Secure appropriate disk space and configure data retention. | |
| 11 | ||
| 12 | ## Usage | |
| 13 | ||
| 14 | ```bash | |
| 15 | docker run -d --name=mfi \ | |
| 16 | -p 6080:6080 -p 6443:6443 \ | |
| 17 | jacekkow/mfi | |
| 18 | ``` | |
| 19 | ||
| 20 | First run wizard should be available at https://127.0.0.1:6443/ | |
| 21 | (note that self-signed certificate is used). | |
| 22 | ||
| 23 | By default container uses Docker data volume for persistence. | |
| 24 | ||
| 25 | You can update such installation by passing `--volumes-from` option | |
| 26 | to `docker run`: | |
| 27 | ||
| 28 | ```bash | |
| 29 | docker pull jacekkow/mfi | |
| 30 | docker stop mfi | |
| 31 | docker rename mfi mfi-old | |
| 32 | docker run -d --name=mfi \ | |
| 33 | -p 6080:6080 -p 6443:6443 \ | |
| 34 | --volumes-from mfi-old \ | |
| 35 | jacekkow/mfi | |
| 36 | docker rm -v mfi-old | |
| 37 | ``` | |
| 38 | ||
| 39 | ## Local storage | |
| 40 | ||
| 41 | If you prefer to have direct access to container's data | |
| 42 | from the host, you can use local storage instead of data volumes: | |
| 43 | ||
| 44 | ```bash | |
| 45 | docker run -d --name=mfi \ | |
| 46 | -p 6080:6080 -p 6443:6443 \ | |
| 47 | -v /srv/mfi:/usr/lib/mfi/data \ | |
| 48 | jacekkow/mfi | |
| 49 | ``` | |
| 50 | ||
| 51 | `/usr/lib/mfi/data` will be automatically populated | |
| 52 | with default configuration if necessary. | |
| 53 | ||
| 54 | File ownership is recursively changed to | |
| 55 | `mfi:mfi` (`500:500`) on each start. | |
| 56 | ||
| 57 | ## Configuration | |
| 58 | ||
| 59 | By default the JVM is started with options `-Xmx1024m`. | |
| 60 | You can override this default using `JAVA_OPTS` environment variable: | |
| 61 | ||
| 62 | ```bash | |
| 63 | docker run -d --name=mfi \ | |
| 64 | -p 6080:6080 -p 6443:6443 \ | |
| 65 | -e "JAVA_OPTS=-Xmx2048m" \ | |
| 66 | jacekkow/mfi | |
| 67 | ``` | |
