Cosa ti dà davvero il self-hosting (e quanto costa)

Un convertitore pubblico è ottimizzato per attività anonime una tantum. Il self-hosting di PDF123 cambia il contratto: i file caricati arrivano su macchine che gestisci tu, e ogni strumento del catalogo è raggiungibile via HTTP, non solo come modulo nel browser.

Cosa ottieni

Il primo vantaggio è la località dei dati. I file arrivano sul tuo pdfx-server, non su un archivio temporaneo che non gestisci. Il secondo è l'interfaccia per sviluppatori sulla stessa macchina: REST sotto /api/v1/…, OpenAPI su /v1/openapi.json, MCP su /mcp e pdfx --cloud puntato al tuo URL di base.

Docker Compose esegue insieme il backend Rust e il portale Next.js, così persone e script condividono un unico catalogo. In quel percorso non c'è alcun installer desktop; l'uso offline è fatto di Compose e CLI (Self-host). Il lavoro locale nativo usa task pdfx:dev accanto al portale; Compose usa task docker:build / task docker:up (API :8080, portale :3000).

Un agente o un processo CI con la tua chiave chiama le stesse operazioni del sito pubblico. Unisci, Comprimi, OCR, converti e il resto mantengono gli stessi percorsi e parametri. Questa identità è il prodotto, non uno slogan.

Gli annunci che finanziano il sito pubblico non fanno parte di un deploy self-hosted. Salta anche il discorso della quota anonima dell'hosting: la pianificazione della capacità diventa tua, compresi i picchi di CPU durante l'OCR o i merge di grandi dimensioni. L'OCR restituisce comunque Markdown (text/markdown) sulla tua macchina; spostare il server non cambia il contratto delle operazioni.

Cosa costa

Possiedi la disponibilità del servizio, l'aggiornamento delle immagini, lo spazio su disco per i file temporanei, TLS e la rotazione delle chiavi. Compose si avvia in fretta; mantenerlo in salute è un impegno continuo. Imposta SECURITY_CUSTOMGLOBALAPIKEY quando vuoi un controllo fisso con API key sulla tua istanza. Le funzionalità opzionali (per esempio URL→PDF con SYSTEM_ENABLEURLTOPDF=true) sono flag che abiliti deliberatamente, non impostazioni predefinite presenti perché le ha il sito pubblico.

Il self-hosting non aggiunge una canvas visiva per «modificare PDF» con un flag. L'offerta resta fatta di strumenti basati su modulo più API. Se ti serve l'editing su canvas, ti serve comunque un prodotto diverso; spostare il server non inventa quell'interfaccia.

Limiti di frequenza e misurazione seguono la configurazione della macchina. Non dare per scontato che le intestazioni e i tetti pubblicizzati dal sito pubblico si trasferiscano invariati; leggi le intestazioni che restituisce la tua istanza quando il budget ti interessa. Le operazioni con molte dipendenze (modelli OCR, convertitori opzionali) falliscono con i codici strutturati missing_dependency / unavailable se sul binario o sul pacchetto di modelli manca l'immagine.

Il rapporto con il sito pubblico

Usa PDF123 ospitato per prove senza configurazione. Gli strumenti del catalogo e le chiamate anonime a /api/v1/ non richiedono account; le risposte espongono X-RateLimit-* e le risposte 429 includono Retry-After (limite di frequenza anonimo).

Scegli il self-host quando lo richiedono regole di conservazione, reti isolate o automazione privata. /llms.txt aiuta gli agenti a scoprire gli strumenti su qualunque URL di base tu esegua; Google Search non lo considera un segnale di posizionamento. MCP e OpenAPI restano disponibili accanto al portale su quella stessa base.

Quando non conviene ancora self-hostare

Se ti serve solo un merge oggi pomeriggio, il modulo ospitato basta. Se ti servono byte privati domani e in tutti i giorni successivi, parti da Compose adesso invece di aggiungere un installer desktop a un'abitudine SaaS. La soluzione offline che supportiamo è documentata su Self-host, non in una scheda di negozio.

Parti da Self-host. Le chiavi e OpenAPI sono su Developers. Per un confronto più breve con i convertitori solo browser, vedi Perché self-hostare un toolkit PDF. Perché Compose è il percorso privato al posto di un .exe, vedi Perché abbiamo evitato l'app desktop.