User Tools

Site Tools


OpenWISP installation on Turris

Information about OpenWISP itself and its features is available at the main page.

Installation pre-requisities:

  1. A Turris router with Turris OS 3.11 or 4.0
  2. Working Internet access from the router
  3. Finished the first Turris OS update
  4. OpenWISP installed on a server according to the guide.

Installation procedure:

  1. Login to LuCI.
  2. Go into System → Software.
  3. In Available packages search for the openwisp-config-openssl package.
  4. If the package is present install it by clicking to Install.
  5. If the package is missing search for the package with OpenSSl on http://downloads.openwisp.io/openwisp-config/latest/ najít balíček s OpenSSL and copy its URL.
  6. In LuCI (see above for the section) insert the URL into the Download and install package field and press OK.
  7. It's necessary to edit the configuration file /etc/config/openwisp as follows (usually only url, verify_ssl and shared_secret should be changed):
# For more information about the config options please see the README
# or https://github.com/openwisp/openwisp-config#configuration-options

config controller 'http'
    option url 'https://openwisp.server.address'
    #option interval '120'
    option verify_ssl '1'
    option shared_secret 'fg5nbsf51snbfg15bsf'
    #option consistent_key '1'
    #option mac_interface 'eth0'
    #option merge_config '1'
    #option test_config '1'
    #option test_script '/usr/sbin/mytest'
    #option uuid ''
    #option key ''
    list unmanaged 'system.@led'
    list unmanaged 'network.loopback'
    list unmanaged 'network.@switch'
    list unmanaged 'network.@switch_vlan'
    # curl options
    #option connect_timeout '15'
    #option max_time '30'
    #option capath '/etc/ssl/certs'

The url parameter must be set according to the real server address (preferably the name address). If TLS certificate verification is needed the address must be consistent to some of the addresses in the certificate. If you don't want to verify the server certificate set verify_ssl to 0. The shared_secret parameter value is obtained from the OpenWISP administration on the page Organizations → <organization name>.

After installation, it's necessary to start the OpenWISP service/daemon using /etc/init.d/openwisp_config start.