community italiana di domotica personale
 
Installare e configurare FileBrowser con Docker su Sonoff iHost

Installare e configurare FileBrowser con Docker su Sonoff iHost

SCOPI DELLA GUIDA:
  • Installare e configurare il tool webgui FileBrowser per la gestione dei volumi di Sonoff iHost
  • Livello di difficoltà: basso
CONCETTI AFFRONTATI:
  • Installazione e configurazione software
COMPONENTI SOFTWARE UTILIZZATE:
  • Sistema operativo eWeLink CUBE di Sonoff iHost
  • Docker per Sonoff iHost
  • FileBrowser per Docker
PREREQUISITI:
  • Sonoff iHost precedentemente configurato e collegato alla rete domestica e, tramite essa, ad Internet
DISPOSITIVI FISICI UTILIZZATI:
GUIDA DEDICATA A utenti:
Sonoff iHost - Square
NOTE E DISCLAIMER
  • qualsiasi eventuale modifica agli impianti domestici dev'essere progettata e realizzata SOLO da personale qualificato;
  • qualsiasi modifica non prevista attuata in proprio è a propria responsabilità personale nonché a proprio rischio e pericolo (i contenuti della presenta pagina hanno infatti puro scopo didattico) e fa decadere garanzia, omologazioni e certificazioni di qualità; dei dispositivi interessati;
  • tutte le tecniche descritte si intendono applicate a software e firmware aggiornati alle ultime versioni disponibili;
  • gli articoli di inDomus sono totalmente indipendenti e non sponsorizzati. Se mai questo cambiasse, verrà segnalato chiaramente sulle pagine oggetto di sponsorizzazione;
  • questa pagina è materialmente scritta e manutenuta da più individui: non ci si aspetti né si pretenda un supporto personale. In caso di difficoltà, chiedere supporto alla community sul nostro forum o sulla nostra chat;
  • se hai bisogno di orientarti, c'è la mappa.
Revisione guida: 1.1

FileBrowser su Sonoff iHost

😊  QUESTA GUIDA È PARTE DEL NOSTRO PERCORSO GUIDATO ALL’INSTALLAZIONE E CONFIGURAZIONE
di HOME ASSISTANT su Sonoff iHost

Abstract

Il motore Docker incluso all’interno dell’ambiente operativo di Sonoff iHost consente di installare una serie di applicazioni, le quale a loro volta si appoggiano su dei “volumi” logici locali presso il quale scrivere i propri contenuti, diversi da caso a caso.

Dato che iHost non dispone di un motore utile a consultare i contenuti dei volumi – che per tanto rimangono ad appannaggio delle applicazione Docker istanziate – una delle possibili soluzioni è l’adozione di FileBowser, una semplice web app – anch’essa implementabile via Docker.

Si parte

Assunti

Si assume che Sonoff iHost sia già operativo, connesso alla rete LAN e, di riflesso, a Internet, e che disponga dell’ultima versione fimware disponibile.

Altresì, si assume che sia stata installata a bordo e formattata una microSD, la quale ospiterà non solo FileBrowser stesso, ma anche i contenuti delle applicazioni che si andranno, nel tempo, a configurare presso iHost.

La presente guida è in italiano, quindi si assume di aver installato su iHost un pacchetto linguistico in lingua italiana, per esempio il nostro.

Infine, a mo’ di esempio assumeremo già esistente un volume logico chiamato “home-assistant“, immaginando di averlo già in uso per l’app Home Assistant.

Creazione volume

Prima cosa da fare è creare un volume logico allo scopo di ospitare i file di FileBrower (database e altro).

Da interfaccia web di sonoff iHost (solitamente raggiungibile via LAN all’indirizzo http://ihost.local), recarsi alla voce di menu “Docker” > “Volume” e poi cliccare su “Crea volume“.

Sonoff iHost - FileBrowser - Crea volume

chiamiamolo “filebrowser“, come da immagine sopra, e clicchiamo su “Conferma” per creare il volume.

Istanziare FileBrowser

Arrivati a questo punto è possibile provvedere all’instanziamento di FileBrowser, il quale viene eseguito come container Docker tramite istanza specifica.

Recarsi dunque alla voce “Docker” > “Lista degli Add-on” e poi cliccare su “Aggiungi Add-on“.

Nella buca di ricerca inserire “filebrowser“, poi cliccare sulla lente d’ingrandimento:

Sonoff iHost - FileBrowser - Aggiunta immagine

selezionare “filebrowser/filebrowser“, poi cliccare su “Aggiungi …“.

Al termine si rientrerà sulla finestra principale degli Add-on inclusi su Sonoff iHost; a questo punto cliccare su “Installare” sul nuovo box dedicato a FileBrowser.

Attendere il tempo del download dell’immagine di FileBrowser dal repository ufficiale di Docker, poi procedere oltre.

Avviare il container

Al termine, sempre presso il box di FileBrowser, cliccare su “Avvia“.
Apparirà un box di configurazione, il quale va configurato come segue:

  • Rete: bridge;
  • Porta:
    • Porta Host: 8080 (o una a piacere)
    • Porta Add-on: 80
  • Volume:
    • Volume dell’host: selezionare quello precedemente creato, ovvero “filebrowser
    • Volume dell’Add-on: “/srv

Riportiamo l’esempio:

Sonoff iHost - FileBrowser - Configurazione container Docker
configurazione d’esempio.

Come si noterà dall’immagine, nel nostro esempio è presente anche un altro volume esemplificativo chiamato “home-assistant“, così come spiegato negli assunti. Questo volume assumiamo infatti che sia in uso anche da parte di un’altra applicazione istanziata via Docker; come si noterà, il path al quale viene associato (voce “Volume dell’Add-on”) è “/srv/home-assistant“, in quanto “/srv” è intesa quale directory “radice” dell’app FileBroweser. 

IMPORTANTE. Tutti gli eventuali volumi da esporre a FileBrowser (per consentirne così l’accesso e la modifica dei contenuti), presenti e futuri, andranno mappati in questo modo.

Al termine della configurazione, cliccare su “Avvia” per avviare il container Docker di FileBrowser.

Accedere a FileBrowser

L’intefaccia di FileBrowser viene esposta sulla porta 8080 dell’iHost spitante tale applicativo (salvo diverse configurazioni a monte). Pertanto, è sufficiente collegarsi tramite browser all’indirizzo:

http://IHOST.LOCAL:8080

Dove ovviamente IHOST.LOCAL potrà anche essere sostituito con l’indirizzo IP assegnato a iHost.

La prima schermata ci darà il benvenuto:

FileBrowser - Primo login

Il primo accesso si ottiene indicando “admin” e “admin” nel campo username e password.

Terminato questo primo passaggio ci si troverà nella pagina principale dell’interfaccia di FileBrowser, presso la quale sarà possibile cominciare ad operare:

FileBrowser - Pagina principale
un’esempio di interfaccia.

Da subito sarà possibile accedere ai contenuti dei volumi extra eventualmente mappati, come nel caso dell’esempio sopra, “home-assistant“.

Riconfigurazione

in caso di nuovi volumi da mappare (magari perché, nel tempo, l’utente ne installa di nuovi), è purtroppo necessario cancellare il container Docker di FileBrowser per ricrearlo di nuovo, mappando questa volta tutti i nuovi volumi logici (oltre quelli già presenti).

Per farlo, recarsi alla voce di menu “Docker” > “Lista degli Add-on” e poi cliccare su “FileBrowser“, e infine sull’icona cestino in alto a destra. 

Infine, ripetere la procedura di configurazione del container di FileBrowser.

Uso

FileBrowser è un’app molto semplice ed intuitiva, non c’è moltissimo da dire. Cliccando sulle varie cartelle e file, è possibile modificarne i contenuti, il nome, creare e cancellare nuove directory e file, ed altro.


Questa pagina è redatta, manutenuta e aggiornata dallo staff di inDomus, un gruppo di persone molto diverse tra loro che trovi, per domande e supporto, sul forum e sulla chat del sito. Alcuni link sono taggati in qualità di affiliati Amazon e riceviamo un compenso dagli acquisti idonei, utile al sostenimento del sito, ma le nostre recensioni sono tutte indipendenti e non sponsorizzate. Se ti sei perso, a tua disposizione c'è la mappa.