Come installare Stirling-PDF su Saplo (toolkit PDF senza inviare documenti all'esterno)

Una fattura da impaginare, la scansione di un contratto da comprimere prima di essere inviata via email, un vecchio documento da passare all'OCR prima di archiviarlo. Ognuna di queste operazioni ha il suo servizio gratuito su Internet, ma ognuna di esse significa caricare il documento su un server altrui e affrontare limitazioni nel piano gratuito (limite di dimensione del file, limite di operazioni giornaliere, watermark sul risultato). Stirling-PDF risolve tutto questo come un unico container Docker sul tuo Box: le stesse operazioni, senza inviare nulla all'esterno e senza contare quante volte hai usato lo strumento oggi. In questa guida ti mostriamo come installare Stirling-PDF su Saplo.

Cos'è Stirling-PDF e a chi si rivolge

Stirling-PDF è una suite di strumenti per PDF self-hosted, basata sull'immagine ufficiale Docker stirlingtools/stirling-pdf, che funziona direttamente nel browser. Troverai oltre cinquanta operazioni in un unico posto: unire e dividere file, convertire PDF in Word, Excel o immagini e viceversa, comprimere, eseguire l'OCR di pagine scansionate, firmare, rimuovere password e molto altro. È particolarmente utile per:

• Uffici che ogni giorno uniscono, dividono o comprimono scansioni e fatture in PDF.
• Chiunque voglia scansionare un documento cartaceo per trasformarlo in testo ricercabile (OCR) senza caricarlo su un servizio esterno.
• Aziende che necessitano di una comoda conversione di PDF in altri formati e viceversa, senza i limiti giornalieri degli strumenti online gratuiti.

Questa è una nicchia diversa da Documenso, che si concentra sulla firma elettronica di contratti tra le parti. Stirling-PDF si concentra sul lavoro con il file PDF stesso, non sul flusso di documenti.

Requisiti

Per installare Stirling-PDF su Saplo, hai bisogno di:

• Un Box con Docker in esecuzione (il motore lo abilita automaticamente all'installazione dal catalogo, è richiesto il nesting nel container, che Saplo ha di default),
• Un minimo di 2 GB di RAM e 5 GB di spazio su disco per l'applicazione stessa. In pratica, si consiglia un Box L per 139 € all'anno: Box M ha esattamente 2 GB di RAM, che è quanto richiesto dall'applicazione stessa, senza margine per il sistema e altri processi, quindi in questo caso il motore Saplo raccomanda il piano superiore.
• Un Dominio o sottodominio *.saploapp.pl incluso nel prezzo di ogni piano, dove verrà installato lo strumento.
• NON hai bisogno di un database separato, Stirling-PDF non mantiene una libreria permanente di documenti: i file entrano, vengono elaborati ed escono, nulla viene salvato in modo permanente.

Dopo l'installazione su un Box L, rimangono 3,8 GB di RAM e 50 GB di spazio su disco, il che significa che puoi ancora ospitare fino a 137 altre applicazioni dal catalogo, ad esempio Vaultwarden o Excalidraw.

Installazione passo dopo passo

1. Nel Pannello Saplo, vai su Catalogo delle applicazioni e seleziona Stirling-PDF (categoria "Business").
2. Indica un Box L o superiore e un dominio o sottodominio dove lo strumento sarà attivo.
3. Conferma l'installazione. Il motore installa un container dall'immagine ufficiale stirlingtools/stirling-pdf nella versione completa (con LibreOffice per la conversione dei formati e Tesseract per l'OCR all'interno), lo espone solo al loopback del Box e lo collega a nginx, che lo serve sul dominio indicato con SSL gratuito.
4. Dopo l'avvio del container, il motore verifica inoltre se Stirling-PDF risponde effettivamente via HTTP sul proprio endpoint di Stato, perché il solo Stato "container in esecuzione" non significa che il processo all'interno non sia entrato in un loop di riavvii poco dopo.
5. Al termine dell'installazione, Stirling-PDF è disponibile sul dominio indicato e pronto per l'uso, senza alcun Account.

Sicurezza: nessun login per impostazione predefinita

Stirling-PDF su Saplo si avvia senza login, esattamente come la demo ufficiale del progetto: chiunque conosca l'indirizzo può elaborare i file. Questa è una decisione consapevole, lo stesso modello di ntfy nel catalogo Saplo. Se hai bisogno di un'istanza privata disponibile solo per te o per il tuo team, abiliti il login manualmente: nelle opzioni del container nel Pannello imposta la variabile SECURITY_ENABLELOGIN su true e riavvia l'applicazione. Al primo avvio con il login abilitato, Stirling-PDF crea l'account admin/admin, che deve essere modificato immediatamente.

L'OCR in italiano richiede l'installazione di un pacchetto di lingua

L'immagine di Stirling-PDF ha i pacchetti di lingua Tesseract integrati per inglese, tedesco, francese, portoghese e cinese semplificato, ma SENZA l'italiano. Affinché l'OCR funzioni in italiano, è necessario aggiungere il file pol.traineddata (disponibile, ad esempio, nel repository tessdata_fast del progetto Tesseract) e copiarlo nel volume di dati del container tramite SSH, seguendo le istruzioni salvate automaticamente nel file STIRLING-PDF-SETUP.txt sul Box dopo l'installazione. Senza questo passaggio, l'OCR funziona, ma non riconoscerà correttamente i caratteri diacritici italiani nel testo scansionato.

Stirling-PDF su Saplo vs strumenti online

Domande frequenti

Stirling-PDF richiede un account o un login? No, non out-of-the-box. L'istanza funziona immediatamente senza login, proprio come la demo ufficiale. Puoi abilitare il login autonomamente nelle opzioni del container, se hai bisogno di un'istanza privata.

L'OCR funziona in italiano out-of-the-box? No, l'immagine include solo l'inglese, il tedesco, il francese, il portoghese e il cinese semplificato. L'italiano deve essere aggiunto manualmente. Le istruzioni si trovano nel file STIRLING-PDF-SETUP.txt sul Box dopo l'installazione.

Stirling-PDF necessita di un database separato? No, l'intera applicazione funziona come un unico container senza database. I documenti non vengono archiviati in modo permanente, ma solo elaborati e restituiti.

I file rimangono sul server dopo l'elaborazione? No, Stirling-PDF non è un archivio di file. Il documento viene inserito, elaborato e restituito; nulla viene salvato in modo permanente nel container.

Qual è il limite di dimensione dei file? Per impostazione predefinita, 200 MB per file. La variabile SYSTEM_MAXFILESIZE nelle opzioni del container può essere aumentata se hai bisogno di più.

Se nella tua azienda gestisci quotidianamente decine di file PDF, unisci offerte, comprimi scansioni, o esegui l'OCR su fatture, scrivici. Ti aiuteremo a scegliere il Box più adatto alla tua suite di strumenti.