https://github.com/freifunk-darmstadt/gluon-firmware-selector

Firmware selector for gluon router images
https://github.com/freifunk-darmstadt/gluon-firmware-selector

firmware-selector firmware-wizard freifunk gluon lede openwrt verteiltesechtzeitjavascript

Last synced: 2 days ago
JSON representation

Firmware selector for gluon router images

• Host: GitHub
• URL: https://github.com/freifunk-darmstadt/gluon-firmware-selector
• Owner: freifunk-darmstadt
• License: agpl-3.0
• Created: 2016-06-03T10:27:30.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2024-10-24T15:48:42.000Z (20 days ago)
• Last Synced: 2024-10-25T21:39:24.813Z (19 days ago)
• Topics: firmware-selector, firmware-wizard, freifunk, gluon, lede, openwrt, verteiltesechtzeitjavascript
• Language: JavaScript
• Homepage: https://firmware.darmstadt.freifunk.net/
• Size: 9.28 MB
• Stars: 22
• Watchers: 13
• Forks: 49
• Open Issues: 10
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
OpenWrt/LEDE Firmware Wizard

---

This Firmware Wizard lets a user select the correct firmware for his device. Directory listings are used to parse the list of available images.

Similar projects:

- [Freifunk Bielefeld Firmware Wizard](https://github.com/freifunk-bielefeld/firmware-wizard/): Based on this wizard, but also supports LEDE and OpenWRT firmware images

- [LibreMesh Chef](https://github.com/libremesh/chef): Firmware wizard of LibreMesh that supports building custom images on demand

### Screenshot

![screenshot of the firmware wizard](screenshot.png)

### Configuration

Image paths and available branches can be set in `config_template.js` which has to be renamed to `config.js`. In addition, directory listings have to be enabled in your prefered web server:

#### Apache Webserver

Create a `.htaccess` file that enables directory listings:

```

Options +Indexes

```

#### Nginx Webserver

For `nginx`, auto-indexing has to be turned on:

```

location /path/to/builds/ {

    autoindex on;

}

```

#### Python Webserver

For testing purposes or to share files in a LAN, Python can be used. Run `python -m http.server 8080` from within this directory (the directory where `README.md` can be found) and you are done.

#### Docker

```

docker build -t gluon-firmware-selector .

docker run -p 80:80 -v /path/to/firmware/:/images:ro -v /path/to/config.js:/usr/share/nginx/html/config.js:ro --name web_firmware gluon-firmware-selector

```

For https support check [jrcs/letsencrypt-nginx-proxy-companion](https://hub.docker.com/r/jrcs/letsencrypt-nginx-proxy-companion)

### List of available router models

All available router models are specified in `devices.js` via that will match against the filenames.

If no hardware revision is given or is it is empty, the revision is extracted from the file name.

```

{

  : {

    : ,

    : {: , ...}

    ...

  }, ...

}

```

If two matches overlap, the longest match will be assigned the matching files. On the other hand, the same match can be used by multiple models without problems.

### License

This program is free software: you can redistribute it and/or modify

it under the terms of the GNU Affero General Public License as published by

the Free Software Foundation, either version 3 of the License, or

(at your option) any later version.