[ci skip] better documentation for conf file
parent
289c245fa2
commit
7891aa2b9a
|
@ -26,13 +26,15 @@ A searchable package list is available on [openwrt.org](https://openwrt.org/pack
|
||||||
|
|
||||||
## Configure
|
## Configure
|
||||||
|
|
||||||
Initial configuration is performed using a config file, `openwrt.conf`. Values read from this file at runtime are used to generate OpenWrt format config files.
|
Initial configuration is performed using a config file, `openwrt.conf`. Values read from this file at runtime are used to generate OpenWrt format config files from templates in `etc/config/*.tpl`.
|
||||||
|
|
||||||
To add or change the base configuration, modify the config templates in `etc/config/<section>.tpl`.
|
You can use the included `openwrt.conf.example` as a baseline, which explains the values.
|
||||||
|
|
||||||
You can of course make persistent changes in the UI and download a backup of your full router configuration by navigating to System > Backup / Flash Firmware and clicking Backup.
|
It is also possible to make persistent changes in the UI and download a backup of your full router configuration by navigating to System > Backup / Flash Firmware and clicking Backup.
|
||||||
|
|
||||||
## Run
|
## Run
|
||||||
|
|
||||||
|
Prepare your `openwrt.conf` file as explained above and execute the `make run` target:
|
||||||
```
|
```
|
||||||
$ make run
|
$ make run
|
||||||
```
|
```
|
||||||
|
|
|
@ -2,37 +2,43 @@
|
||||||
|
|
||||||
## general
|
## general
|
||||||
# source image for Raspberry Pi build target
|
# source image for Raspberry Pi build target
|
||||||
SOURCE_IMG=openwrt-19.07.2-brcm2708-bcm2708-rpi-ext4-factory.img
|
SOURCE_IMG=openwrt-19.07.3-brcm2708-bcm2708-rpi-ext4-factory.img
|
||||||
# source for build (x86) target
|
# source for build (x86) target
|
||||||
OPENWRT_SOURCE_VER=19.07.3
|
OPENWRT_SOURCE_VER=19.07.3
|
||||||
# final tag for built Docker image
|
# image tag for pre-built Docker image, or if building locally
|
||||||
BUILD_TAG=openwrt
|
BUILD_TAG=openwrt
|
||||||
# container name
|
# container name
|
||||||
CONTAINER=openwrt_1
|
CONTAINER=openwrt_1
|
||||||
ROOT_PW=changeme123
|
ROOT_PW=changeme123
|
||||||
|
|
||||||
# docker network settings
|
## Docker network settings
|
||||||
# wan
|
# name of the WAN Docker network
|
||||||
WAN_NAME=openwrt-wan
|
WAN_NAME=openwrt-wan
|
||||||
# host interface which will provide the WAN link for OpenWRT
|
# host interface which will provide the WAN link for OpenWRT
|
||||||
WAN_PARENT=eth0
|
WAN_PARENT=eth0
|
||||||
|
# upstream DNS for OpenWrt
|
||||||
UPSTREAM_DNS_SERVER=8.8.8.8
|
UPSTREAM_DNS_SERVER=8.8.8.8
|
||||||
|
|
||||||
# Static IP address configuration for OpenWRT LAN
|
# name of the LAN Docker network
|
||||||
LAN_NAME=openwrt-lan
|
LAN_NAME=openwrt-lan
|
||||||
# host interface which will provide the LAN link for OpenWRT
|
# Host interface which will provide the LAN link for OpenWRT.
|
||||||
LAN_PARENT=eth1
|
# Can be a physical interface or a VLAN of the primary interface.
|
||||||
|
# For example if WAN_PARENT is eth0, LAN_PARENT can be eth0.10 for
|
||||||
|
# VLAN 10. VLAN interface will be created if it doesn't exist.
|
||||||
|
LAN_PARENT=eth0.10
|
||||||
|
# DNS search domain for LAN DHCP clients
|
||||||
LAN_DOMAIN=home
|
LAN_DOMAIN=home
|
||||||
|
# Subnet configuration for LAN network
|
||||||
LAN_SUBNET=192.168.16.0/24
|
LAN_SUBNET=192.168.16.0/24
|
||||||
LAN6_SUBNET=fd99:1234::/48
|
LAN6_SUBNET=fd99:1234::/48
|
||||||
# Set LAN_ADDR to something other than the first available address
|
# Set LAN_ADDR to something other than the first available address
|
||||||
# in the subnet - Docker will claim this address for the host
|
# in the subnet - Docker will claim this address for the host.
|
||||||
LAN_ADDR=192.168.16.2
|
LAN_ADDR=192.168.16.2
|
||||||
# openwrt doesn't accept CIDR notation; must match LAN_SUBNET
|
# openwrt doesn't accept CIDR notation; must match LAN_SUBNET
|
||||||
LAN_NETMASK=255.255.255.0
|
LAN_NETMASK=255.255.255.0
|
||||||
|
|
||||||
# wifi settings
|
# wifi settings
|
||||||
WIFI_IFACE=wlp2s0
|
WIFI_IFACE=wlan0
|
||||||
WIFI_SSID=test123
|
WIFI_SSID=test123
|
||||||
WIFI_ENCRYPTION=psk2
|
WIFI_ENCRYPTION=psk2
|
||||||
WIFI_KEY=12345678
|
WIFI_KEY=12345678
|
||||||
|
|
Loading…
Reference in New Issue