======  USB Autorun  ======
This feature can be used to automatically launch a shell script or perform a software/config update as soon as an USB storage stick has been plugged in. For authentication, a file called ''autorun.key'' must exist in the root directory of a FAT16/32 formatted stick.
It can be downloaded from that page and holds the SHA256 hash key of the admin password. The file can hold multiple hashes which will be processed line-by-line during authentication which can be used for setting up more systems with different admin
passwords. For new devices with an empty password the hash key
''e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855''
can be used.
The hash keys can be generated by running the command ''echo -n "<admin-password>" | sha256sum'' on a Linux system or an Internet hash key generator (search for "sha-256 hash calculator").
Once authentication has succeeded, the system scans for other files in the root directory which can perform the following actions:
 
  - For a configuration update: ''cfg-<SERIALNO>.zip'' (e.g. ''cfg-00112B000815.zip''), or if not available ''cfg.zip''
  - For a software update: ''sw-update.img''
  - For running a script: ''autorun.sh''

===== Example autorun.key =====
<code - autorun.key>
# corresponds to password in factory defaults
# as of release 3.8 the password in factory default is an empty string hence the hash is ''echo -n "" | sha256sum''
d6414f06abe9d25df078def16971fc48a0c18fb5da799c141cc8c555683467a7
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
</code>

===== Procedure =====

The autorun feature need to be enabled. This is case case either in the factory state or when you have it enabled on purpose in the Config. 

  - Please do not plug in the USB Stick before the System is bootet completly (Status LED need to light steady green). 
  - After that pluging the USB Stick.
  - If the Autorun was triggert correctly all LEDs need to flash GREEN at the same time


===== Function is not always enabled =====

Please keep in mind that the usb autorun function is not always enabled:

  - It's enabled in Factory State until you define your admin password
  - After that you need to enable it either via Webinterface or config parameter: ''autorun.status=1''

===== Useful USB autorun =====

  * [[configuration:firmware-update|Firmware update]]
  * [[configuration:software-update|Software update]]
  * [[configuration:config-update|Config update]]