diff options
author | Karel Kočí <cynerd@email.cz> | 2020-10-07 23:01:36 +0200 |
---|---|---|
committer | Karel Kočí <cynerd@email.cz> | 2020-10-07 23:01:36 +0200 |
commit | 26edea6c1cb08dee516af1762381d9cafcb8f812 (patch) | |
tree | fe3e4f2b25ff0e91070d9971bf1994ba12ceba9d /medkit-initial-config/files/README.md | |
parent | 033f0f48bad807b145aabf58617846e69b9df9c0 (diff) | |
download | openwrt-personal-pkgs-26edea6c1cb08dee516af1762381d9cafcb8f812.tar.gz openwrt-personal-pkgs-26edea6c1cb08dee516af1762381d9cafcb8f812.tar.bz2 openwrt-personal-pkgs-26edea6c1cb08dee516af1762381d9cafcb8f812.zip |
medkit-initial-config: add new package
Diffstat (limited to 'medkit-initial-config/files/README.md')
-rw-r--r-- | medkit-initial-config/files/README.md | 50 |
1 files changed, 50 insertions, 0 deletions
diff --git a/medkit-initial-config/files/README.md b/medkit-initial-config/files/README.md new file mode 100644 index 0000000..528f20b --- /dev/null +++ b/medkit-initial-config/files/README.md @@ -0,0 +1,50 @@ +Medkit initial system configuration +----------------------------------- +This package provides script that allows limited configuration of router after +medkit is used. The idea is to allow users to preconfigure router in a way they +can connect to it in secure manner over WiFi if needed. + +It is applied only with first boot on medkited router. It intentionally does not +work with just factory reset, medkit reflash is required. + +## Usage +User places alongside medkit configuration file to flash drive. The name of file +has to be in format `BOARD-medkit-config.json` where `BOARD` is name of board +consistent with medkit prefix. + +## Configuration file format +Configuration file has to contain valid JSON. + +### Example configuration +``` +{ + "foris_password": "m4ZZMC9cpyu3xpbw", + "system_password": "Wru4FU0TLw8avIVY", + "wireless": { + "ssid": "TurrisConfigWifi", + "key": "tScqsSAr0DXEqUe0" + } +} +``` + +### Foris Password +Option `foris_password` can be used to configure password for Foris web interface +and that way skip initial step in setup. + +This is suggested to be used as web interfaces allows anyone to set initial +password. That makes router administration accessible by anyone. By setting +password even before WiFi or/and Foris are started prevents access to just +everyone. + +### System Password +Option `system_password` can be used to configure password for `root` account on +router. This is password used by LuCI web interfaces as well as SSH. + +This is not essentially required on Turris, because in default root account is +blocked for interactive login. This is included rather for convenience for cases +when user wants to use SSH rather than Foris. + +### Wireless AP configuration +Option `wireless` has to be set to object with `ssid` and `key` fields. It +configures first radio it can access on system to AP mode with provided SSID and +key (password). |