SmartTicket è una piattaforma self-hosted per ticketing & knowledge collaboration. Un singolo binario statico, SQLite integrato, RBAC, monitoraggio SLA e RAG con il tuo LLM. Deployabile in cinque minuti, con pieno controllo sui tuoi dati.
$ git clone https://github.com/liliang-cn/smartticket && cd smartticket && docker compose up -d
L'essenziale, esposto con chiarezza — per le persone e per i motori AI che riassumono questa pagina.
docker compose upTicket, SLA, knowledge base con versioning, controllo degli accessi basato sui ruoli, isolamento per cliente e assistenza AI — tutto integrato, tutto in esecuzione da un singolo processo che controlli tu.
Priorità & severità, assegnazione, conversazioni a thread, allegati, flusso di stato e audit trail — dall'apertura alla risoluzione.
Obiettivi di risposta e risoluzione per livello, livelli di supporto configurabili e tracciamento degli abbonamenti per nodo/anno.
Articoli con versioning, controlli di visibilità pubblica/interna, ricerca full-text e semantica e un'esperienza di lettura pulita.
Ruoli, permessi granulari e un modello actor a livello di servizio che limita ogni cliente ai soli propri ticket — sia via REST che via MCP.
Qualsiasi provider compatibile OpenAI per chat ed embedding — OpenAI, Azure, DeepSeek, Ollama, vLLM. RAG sulla tua knowledge base, chiavi cifrate a riposo.
Risposte, assegnazioni e cambi di stato appaiono come notifiche live in-app — nessun server email necessario per rimanere aggiornato.
Esporta ticket, knowledge base, utenti, prodotti e servizi in JSON, CSV, XML o Markdown. I tuoi dati sono portabili per design.
Imposta il nome del prodotto, il colore accent e il logo dalla pagina impostazioni — applicati su tutta la console e la schermata di accesso.
Un server Model Context Protocol espone ticket & risposte come strumenti, così gli agenti possono smistare e rispondere in modo programmatico.
SmartTicket viene distribuito come singolo binario autonomo che serve insieme la console web e le API. Nessun server di database, nessuna message queue, nessun reverse proxy necessario per iniziare.
# Recommended — one command, nothing else to install git clone https://github.com/liliang-cn/smartticket.git cd smartticket # (recommended) generate strong secrets echo "SMARTTICKET_JWT_SECRET=$(openssl rand -hex 32)" > .env echo "SMARTTICKET_SECRET_KEY=$(openssl rand -hex 32)" >> .env docker compose up -d # → http://localhost:6533 # login: admin@smartticket.local / admin123 (change it!)
# Prerequisites: Go 1.25+, Node 20+, pnpm git clone https://github.com/liliang-cn/smartticket.git cd smartticket # builds the console and embeds it into one static binary make build-all ./build/smartticket serve --config configs/config.dev.yaml # → http://localhost:6533
# Build once, install the single binary make build-all sudo cp build/smartticket /usr/local/bin/ # Set persistent secrets + point at the prod config # (edit storage.data_path in configs/config.prod.yaml first) export SMARTTICKET_JWT_SECRET=$(openssl rand -hex 32) export SMARTTICKET_SECRET_KEY=$(openssl rand -hex 32) smartticket serve --config configs/config.prod.yaml # Put TLS in front with Caddy/Nginx, or use the # systemd unit in deployments/systemd/.
docker compose up avvia l'intera app sulla porta 6533.Settings.AI Providers.Tutto — ticket, knowledge base, il RAG vector store e la configurazione — risiede nel volume smartticket-data (un singolo file SQLite più gli upload). Esegui il backup copiando il volume; ripristina rimettendolo al suo posto.
SmartTicket è single-tenant per design: un'organizzazione, un'istanza. Non c'è un backend SaaS che chiama casa, nessun database multi-tenant condiviso e nessun servizio di terze parti obbligatorio.
┌─ your server ──────────────┐ │ smartticket (1 binary) │ │ ├─ web console :6533 │ │ ├─ REST API :6533 │ │ ├─ MCP server (stdio) │ │ └─ SQLite + RAG (vol) │ └────────────┬───────────────┘ │ optional, you choose your LLM provider
Configura provider di chat ed embedding in modo indipendente — ciascuno con il proprio base URL, modello e chiave. Gli articoli della knowledge base vengono indicizzati in un vector store integrato per risposte retrieval-augmented.
Apri Settings → Access, aggiungi l'URL dei metadati del tuo identity provider, mappa il claim email, quindi abilita l'applicazione SSO per il team…
Go sul backend, React sul frontend, SQLite sotto. Nessun runtime esotico, nessuna licenza per posto, nessuna dipendenza a sorpresa.
No. SQLite è integrato direttamente nel binario e non sono necessari altri servizi. L'intera applicazione è un singolo processo — è proprio questo il punto.
Con Docker: git pull && docker compose up -d --build. I tuoi dati risiedono in un volume nominato e non vengono toccati dai rebuild. Dal sorgente: git pull && make build-all e riavvia il binario. Le migrazioni dello schema vengono eseguite automaticamente all'avvio.
No — ticket, SLA, knowledge base e RBAC funzionano tutti senza alcun LLM configurato. Le funzionalità AI sono opzionali: aggiungi un provider solo se desideri la ricerca semantica e le risposte RAG.
No. Gli utenti con ruolo cliente sono limitati a livello di servizio ai soli ticket della propria organizzazione — la stessa isolamento si applica alle REST API e al server MCP.
Copia il volume dei dati (il file SQLite, il RAG store e gli allegati caricati). Per ripristinare, rimettilo al suo posto e avvia il binario. Puoi anche esportare tutto in JSON/CSV/XML/Markdown dalla schermata Dati.
Il software è open source e gratuito per il self-hosting. Gli unici costi sono il server su cui lo esegui e — se abiliti l'AI — le tariffe del tuo provider LLM.
Clonalo, esegui un comando e avrai una piattaforma completa di ticketing e knowledge base sulla tua infrastruttura.