The-Y CRM sul tuo server
Un solo comando, nessun file di configurazione. L'installer genera da solo tutte le password, riconosce l'ambiente del tuo server e configura tutto. La chiave di licenza la inserisci dopo, comodamente nell'app.
Aggiornato al 13 nov 2026 (versione 1.1.66)
- Un server Linux (accesso root/SSH). Per iniziare bastano anche ~2 CPU / 4 GB di RAM / 40 GB SSD, ad es. netcup VPS 500 (2 core, 4 GB) da 8,26 €/mese IVA tedesca del 19 % inclusa, con durata minima di 12 mesi (aggiornato al 12 nov 2026, fonte: netcup).
- Docker e Docker Compose (il passaggio 1 mostra come installarli se mancano).
- Un dominio (ad es.
crm.your-company.com) il cui DNS punta al server. Senza dominio funziona solo nella tua rete (rete domestica). - Una chiave di licenza: Paid (senza limiti; Founder 10 €/mese o Lifetime 240 € una tantum, in Alpha e Beta) dall'email di benvenuto Founder o dopo l'acquisto su the-y.at, oppure una chiave gratuita (con i limiti di Free): registrati su crm.the-y.at → Settings → License → “Create free key”.
→ Di quale server ho bisogno? Consigli sulle dimensioni (piccolo/medio/grande), porte e architettura nel dettaglio.
Guardalo prima di installarlo
Prova prima The-Y CRM nella demo: dati di esempio, senza registrazione, cancellata dopo 24 ore. Per il tuo server, registrati gratis e crea la tua chiave gratuita in Settings → License.
Free: gratis per sempre fino a 3 utenti, in cloud o sul tuo server. Non vuoi gestire un server? Cloud Pro: 20 €/mese per azienda, tutti gli utenti e i marchi, valido in Alpha e Beta, server in Austria (data center a Vienna). The-Y CRM è in Alpha. Tutte le funzioni e i prezzi: The-Y CRM
-
Installare Docker (se non c'è ancora)
Controlla con
docker version. Se Docker manca, installalo con lo script ufficiale:curl -fsSL https://get.docker.com | sh
Sui server con un pannello (Plesk/cPanel/Virtualmin) Docker spesso c'è già o si installa con un clic.
Docker stesso consiglia questo script di comodo per server di test e sviluppo; per l'uso a lungo termine Docker descrive l'installazione dal suo repository di pacchetti (aggiornato al 12 nov 2026, fonte: Docker, guida per Ubuntu).
-
Puntare il dominio sul server
Dal provider del tuo dominio imposta un record A per il dominio (ad es.
crm.your-company.com) verso l'indirizzo IP del tuo server. Può volerci qualche minuto prima che si propaghi ovunque. -
Avviare l'installer
Un unico comando sul server (come root, o con un utente nel gruppo
docker):curl -fsSL https://the-y.at/install.sh -o install.sh && bash install.sh
L'installer ti chiede dominio, email dell'admin, password (facoltativa) e nome dell'azienda, più il ruolo del server (singolo, server principale o server di failover: “master” o “slave” nell'installer), backup giornalieri, aggiornamenti notturni, protezione del server (firewall, fail2ban, aggiornamenti di sicurezza) e il centralino; poi fa il resto: genera tutte le password, configura il database e il primo admin e riconosce in automatico se sul tuo server gira già un web server. A seconda di questo, prosegui con uno dei tre casi qui sotto.
Dalla 1.1.58 chiede anche se configurare pure il centralino: con “no” resta tutto come prima, e puoi aggiungerlo in qualsiasi momento (centralino).
A seconda del tuo server: uno di questi tre casi
🟢 Server nuovo
Sulle porte 80/443 non gira nulla. L'installer porta con sé il proprio HTTPS (ottiene in automatico un certificato Let's Encrypt).
Non devi fare nient'altro: apri il tuo dominio nel browser. Se per un attimo la pagina non si carica, controlla DNS e porte 80+443.
🧩 Server con pannello
Virtualmin, Plesk o cPanel occupano già 80/443. L'installer passa automaticamente in modalità proxy (l'app resta in ascolto in locale su 127.0.0.1:8090).
Nel pannello aggiungi un reverse proxy / proxy pass per il tuo dominio, con destinazione:
http://127.0.0.1:8090
e attiva nel pannello HTTPS/Let's Encrypt per il dominio. Fatto.
⚙️ Solo Apache/Nginx
Hai un tuo web server senza pannello. Anche qui l'app gira su 127.0.0.1:8090: aggiungi un vhost reverse proxy (esempi qui sotto) e ottieni un certificato con certbot.
Vhost Nginx (caso C)
server {
server_name crm.your-company.com;
location / {
proxy_pass http://127.0.0.1:8090;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Host $host;
proxy_set_header X-Forwarded-Proto https;
proxy_set_header X-Real-IP $remote_addr;
}
}
# then: sudo certbot --nginx -d crm.your-company.com
Vhost Apache (caso C)
<VirtualHost *:443>
ServerName crm.your-company.com
ProxyPreserveHost On
ProxyPass / http://127.0.0.1:8090/
ProxyPassReverse / http://127.0.0.1:8090/
RequestHeader set X-Forwarded-Proto "https"
# SSLEngine + certificate via certbot --apache
</VirtualHost>
Ultimo passo: accedi e inserisci la licenza
-
Apri nel browser e accedi
Vai su https://tuo-dominio e accedi con l'email dell'amministratore e la password che l'installer ti ha mostrato alla fine.
-
Inserisci la chiave di licenza, direttamente nell'app
Al primo avvio te la chiede la procedura guidata, oppure vai su Settings → License e inserisci la chiave. Nessun file di configurazione necessario. Il self-hosting richiede una chiave di licenza: Paid (senza limiti) oppure free (gli stessi limiti di Free in cloud: 3 utenti, 1.000 messaggi in uscita e 200 minuti di chiamate in uscita al mese, 2 chiamate contemporanee, 2 GB, 1 marchio; senza assistenza). Senza chiave l'istanza funziona completamente per 14 giorni dal primo avvio, poi resta in sola lettura finché non inserisci una chiave. Per passare più avanti da free a Paid basta inserire la chiave Paid: i tuoi dati restano.
Gli aggiornamenti arrivano da soli: dalla 1.1.53 l'installazione si aggiorna ogni notte alle 03:30 ora del server (più un ritardo casuale fino a 45 minuti) con
update.sh: prima viene fatto un backup, poi la nuova versione viene controllata e, se qualcosa va storto, torna a girare la versione precedente. Le installazioni precedenti alla 1.1.53 usano Watchtower finché non passi al nuovo sistema (circa 5 minuti). Un banner nell'app segnala le nuove versioni. Puoi anche aggiornare tu in qualsiasi momento:cd ~/the-y-crm && bash update.shSenza
update.sh (installazioni precedenti alla 1.1.53): docker compose pull && docker compose up -d. All'avvio l'app applica da sola le modifiche al database; dopo un aggiornamento non c'è altro da fare. Per i backup, se rispondi sì (impostazione predefinita) l'installer configura un backup giornaliero di database e file: alle 03:00 UTC, conservato 14 giorni, gli ultimi 3 restano sempre. Senza, fai regolarmente il backup di Postgres e del volume MinIO, ad esempio con un semplice dump del database (pg_dump funziona anche mentre il database è in uso, fonte: PostgreSQL):cd ~/the-y-crm && docker compose exec -T postgres \ pg_dump -U crm crm | gzip > crm-backup-$(date +%F).sql.gz
Centralino
Il centralino integrato (Asterisk per le chiamate, coturn per le videoriunioni) è facoltativo. Tutto il resto funziona anche senza.
Installarlo subito o aggiungerlo dopo (dalla 1.1.58)
install.sh chiede se configurare anche il centralino, solo su server Linux che eseguono Docker direttamente (non Docker Desktop, non “rootless”), perché l'audio passa dalla rete dell'host. Con sì, al termine funzionano le linee del tuo operatore telefonico, gli interni, i menu vocali, le code, la segreteria, le registrazioni e il telefono nel browser; la configurazione la genera il CRM da solo. Con no resta tutto come prima. Puoi aggiungerlo in qualsiasi momento, anche più volte: ciò che esiste già resta:
cd ~/the-y-crm && curl -fsSL https://the-y.at/install.sh -o install.sh && bash install.sh --add-phone
- Controllo delle porte: per prima cosa l'installer verifica che 5060/udp, 3478, 5038 e 8188 siano libere. Se sono occupate, propone “no” e le elenca.
- Indirizzo IPv4 pubblico: te lo chiede e propone il tuo indirizzo o quello a cui punta il tuo dominio, senza interpellare servizi esterni. Dietro NAT memorizza anche il tuo indirizzo locale.
- Credenziali:
AMI_SECRETeTURN_SECRETvengono generate a caso e salvate solo nel.env. - Annunci: scarica gli annunci standard in inglese (Asterisk Core Sounds, 2,4 MB, con checksum) da downloads.asterisk.org. Senza internet: scarica il file altrove, copialo sul server, poi
PBX_ANSAGEN_DATEI=<file> bash telefonanlage.sh --ansagen. - Telefono nel browser: con il Caddy integrato (caso A) aggiunge da solo
/asterisk-ws. Dietro un tuo web server (caso B/C), inoltra/asterisk-wscome WebSocket ahttp://<PBX_DOCKER_GW>:8188/ws(valore preso dal.env, di solito172.17.0.1); l'installer mostra le righe con il valore giusto. Senza questo inoltro funzionano le chiamate sulle linee e i telefoni da scrivania, solo il telefono nel browser no. - Firewall: se il firewall l'ha configurato l'installer (hardening, ufw), ci apre le porte del centralino; altrimenti te le elenca (
bash telefonanlage.sh --ports). Non disattiva mai un firewall. - Senza domande:
PBX=1 PBX_PUBLIC_IP=203.0.113.10 bash install.sh(PBX=0= no; dietro NAT anchePBX_LOCAL_IP=<your address>).
Porte (in entrata; anche nel firewall del tuo provider o come port forwarding sul router, se il server è dietro NAT): 5060/udp (SIP), 10000–20000/udp (audio), 3478/udp + 3478/tcp (STUN/TURN per le videoriunioni), 49152–49252/udp (TURN), 443/tcp (telefono nel browser, comunque già aperta per l'app). Mai aprire verso l'esterno: 5038/tcp (AMI) e 8188/tcp (Asterisk HTTP).
# Nginx — in the HTTPS vhost of your domain, before “location /”
location = /asterisk-ws {
proxy_pass http://172.17.0.1:8188/ws;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_read_timeout 3600s;
proxy_send_timeout 3600s;
}
# Apache — a2enmod proxy_wstunnel; before “ProxyPass /” ProxyPass /asterisk-ws ws://172.17.0.1:8188/ws ProxyPassReverse /asterisk-ws ws://172.17.0.1:8188/ws
Aggiornamenti: dopo ogni aggiornamento con un nuovo worker, update.sh riprende i file di base del centralino; il sistema in funzione li ricarica e le chiamate continuano. Le tue parti personalizzate vanno in pbx/asterisk/include/. Le nuove versioni di Asterisk e coturn arrivano con bash install.sh --add-phone. Per controllare lo stato: bash telefonanlage.sh --pruefen.
Disattivarlo: docker compose rm -sf asterisk coturn, nel .env togli :docker-compose.pbx.yml da COMPOSE_FILE e imposta PBX=0, poi docker compose up -d. I file in pbx/ restano.
SELF-HOSTING.md (in tedesco) → Telefonie. --add-phone non tocca i centralini configurati a mano (prima della 1.1.58); per loro vale ancora la sezione qui sotto.Cosa vale dalla 1.1.46
Se usi il centralino integrato, dalla versione 1.1.46 vale quanto segue. La versione arriva con gli aggiornamenti automatici; le parti elencate sotto “Non nell'immagine” le riprendi tu una volta sola.
- Chiamate contemporanee: senza una chiave a pagamento la tua installazione conta come Free: al massimo 2 chiamate contemporanee (sulle tue linee e su WhatsApp, in entrata e in uscita). Puoi cambiarlo con
PBX_CONCURRENT_FREEnel.env(un numero,-1= nessun limite). Con una chiave a pagamento non c'è limite di piano. - Limite per l'intero server:
PBX_MAX_CONCURRENT(predefinito 80,0= nessun limite del server). App e worker leggono lo stesso.enve devono vedere lo stesso numero. Un nuovo valore vale solo dopo aver ricreato entrambi:docker compose up -d app worker. Senza ilulimitsqui sotto, imposta al massimo 55. - Non nell'immagine: gli aggiornamenti automatici sostituiscono solo le immagini. Riprendi una volta dal rilascio queste parti:
pbx/asterisk/pjsip.conf(blocco[webrtc-endpoint]),pbx/asterisk/modules.conf(nuovo; versione attuale: the-y.at/pbx/asterisk/modules.conf.txt),pbx/asterisk/rtp.conf(RTP 10000–20000, da aprire anche nel firewall) e, nel servizio composeasterisk, ilulimitse il mount permodules.conf:
asterisk:
# … existing entries stay …
ulimits:
nofile:
soft: 65536
hard: 65536
volumes:
# … existing entries stay …
- ./pbx/asterisk/modules.conf:/etc/asterisk/modules.conf:ro
Poi ricrea il container una volta, meglio in un momento tranquillo (le chiamate in corso cadono):
docker compose up -d asterisk
Annunci e avviso prima delle registrazioni: dalla 1.1.51 non c'è più la voce sintetica. Ogni account registra da sé i propri annunci (nel browser) o li carica come file. Senza una tua registrazione il sistema riproduce l'annuncio standard in inglese, dove esiste; prima di una registrazione, se manca un tuo avviso, chi chiama sente solo un bip (l'app mostra allora un avviso chiaro). Altro: Avviso prima delle registrazioni · Note di rilascio 1.1.51 · Note di rilascio 1.1.46 · Chiamate contemporanee.
Avviso di chiamata e numeri brevi dei gruppi di chiamata (dalla 1.1.64)
- L'avviso di chiamata è un interruttore per ogni interno nell'app (Settings → Phone → Extensions & devices → Extensions → “Ringing & voicemail” → “Allow call waiting”, disattivato di default). Nessun nuovo modulo, nessuna nuova impostazione nel
.env; i telefoni Snom ricevonocall_waiting=onper l'account. - Numeri brevi dei gruppi di chiamata: ogni gruppo di chiamata si può comporre direttamente con il suo numero breve (ad es. 5201), lo stesso numero usato per
*45e*81. Puoi cambiarlo quando modifichi il gruppo. - Dopo l'aggiornamento il worker rigenera una volta il centralino (generatore 1.1.64, ricarica del dialplan, le chiamate in corso restano attive).
- Ruolo del database: se la tua installazione usa
APP_DATABASE_URL(ruolocrm_app), all'avvio la migrazione 0269 gli toglie i diritti su nove tabelle interne che l'app non legge mai tramite questo ruolo. SenzaAPP_DATABASE_URLnon cambia nulla.
Dettagli: SELF-HOSTING.md → “Anklopfen und Kurzwahl der Gruppenrufe” (in tedesco) · Note di rilascio 1.1.64 · Avviso di chiamata nell'app
Telefoni da scrivania e provisioning Snom (dalla 1.1.62)
- Nome SIP: i telefoni ricevono il tuo dominio (
BASE_DOMAIN) come server; per usare un nome tuo impostaPBX_SIP_HOST(ad es.sip.your-company.com). - Accesso cifrato (TLS, facoltativo): metti il certificato (con la catena) e la chiave del tuo nome SIP in
pbx/asterisk/certs/dev-sip.crtedev-sip.key(proprietario 1000, permessi 640), impostaPBX_TLS_PORT=5061in.env, apri la porta5061/tcpnel firewall o nel router e riavvia app e worker (docker compose up -d app worker). ImpostaPBX_TLS_PORTsolo quando la porta è aperta dall'esterno, altrimenti i telefoni da scrivania Snom dell'elenco non si registrano. SenzaPBX_TLS_PORTresta tutto su UDP 5060 come prima. Le basi DECT restano sempre su UDP. - Configurazione automatica Snom: passa dal tuo dominio (
APP_URL, solo https con un certificato valido). Con la chiave del tuo account SRAPS presso Snom (SRAPS_ACCESS_KEY_ID,SRAPS_ACCESS_KEY_SECRET) il telefono trova da solo le sue impostazioni; altrimenti inserisci l'indirizzo a mano o tramite l'opzione DHCP 66. Dietro un tuo Nginx impostaX-Forwarded-Proto(altrimenti 403) e disattiva l'access log per/prov/. - Firmware per serie (dalla 1.1.63, facoltativo):
PROV_SNOM_FW_D1,PROV_SNOM_FW_D3,PROV_SNOM_FW_D7,PROV_SNOM_FW_D8= la versione che i tuoi telefoni di quella serie devono caricare. Solo la versione → file dal server di download di Snom; versione più un tuo indirizzo (ad es."<version> https://files.your-company.com/snom/snom{type}-{version}-SIP-r.bin") → dal tuo server (solo https). Vuoto = nessuna impostazione, i telefoni tengono il loro firmware. Inserisci solo versioni che hai provato su un dispositivo.PROV_SNOM_FIRMWARE(per modello) funziona ancora e ha la precedenza. - Due file di impostazioni (dalla 1.1.63): al suo indirizzo il telefono scarica un breve elenco e poi il file del modello e quello del dispositivo; sul telefono e sul web server non cambia nulla. Se un modello non lo accetta:
PROV_SNOM_ONE_FILE=on(o una sola serie, ad es.D8) = tutto in un unico file come fino alla 1.1.62. Con un'impostazione firmware, dalla 1.1.64 l'indirizzo del file firmware (firmware_status) sta nel file del dispositivo, così il file del modello è uguale per tutti i telefoni dello stesso modello. - Nome di chi chiama dai tuoi contatti: solo con
PBX_CALLER_NAME_URL= l'indirizzo a cui il centralino raggiunge l'app (ad es.http://<server-ip>:<app-port>). - Freno d'emergenza:
PBX_DESK_PHONE=offdisattiva di nuovo le nuove funzioni dei telefoni da scrivania (spie luminose, risposta per assente, paging, spia “Do not disturb”, nome di chi chiama, TLS).
Nel dettaglio: SELF-HOSTING.md → “Snom-Tischtelefone und Snom-DECT automatisch einrichten” (in tedesco) · Note di rilascio 1.1.63 · 1.1.62 · Telefoni da scrivania nell'app
Senza dominio nella rete di casa (dalla 1.1.58)
Su un server di casa (ad es. CasaOS/ZimaOS, TrueNAS) senza dominio e senza certificato, il CRM funziona anche via http://<server IP>. È pensato solo per la tua rete: la connessione non è cifrata. Per accedere dall'esterno usa un dominio con https.
Con install.sh (dalla 1.1.59): quando l'installer ti chiede il dominio, inserisci semplicemente l'indirizzo IP del server (ad es. 192.168.1.50). L'installer scrive poi da solo i valori qui sotto e te lo segnala.
A mano: nel .env inserisci l'indirizzo con http:// al posto del dominio (sostituisci l'IP di esempio), poi esegui docker compose up -d nella cartella di installazione:
CADDY_DOMAIN=http://192.168.1.50 # with “http://” in front, Caddy fetches no certificate BASE_DOMAIN=192.168.1.50 # just the address, without http:// and without a path APP_URL=http://192.168.1.50 # starts with http:// → signing in over http works, links point to this address PUBLIC_BASE_URL=http://192.168.1.50
Se un app store apre l'app direttamente su una porta (senza Caddy), quell'indirizzo, porta compresa, va in APP_URL, ad es. APP_URL=http://192.168.1.50:3000. La pagina di accesso mostra allora l'avviso che la connessione nella rete di casa non è cifrata.
Link e immagini nelle email (dalla 1.1.59): l'app costruisce i link in email e notifiche (inviti, file del calendario, link per disiscriversi e per i sondaggi, report) a partire da APP_URL, appena questo inizia con http://. Quindi imposta APP_URL esattamente come apri l'app nel browser (con la porta, se serve). Questi link funzionano solo dentro la tua rete. L'app incorpora nell'email il logo e le immagini dei modelli email, così i destinatari li vedono.
Lingua dell'interfaccia (dalla 1.1.59)
Chi apre l'app per la prima volta (senza aver ancora scelto una lingua) la vede nella lingua del browser: tedesco, inglese, turco o italiano (dalla 1.1.70, non ancora rivisto da madrelingua), altrimenti tedesco. Per fissarla, impostala nel .env, poi esegui docker compose up -d app nella cartella di installazione:
DEFAULT_LOCALE=en # de, en, tr or it
Ordine: DEFAULT_LOCALE > browser > tedesco. Il selettore della lingua nell'app e la lingua del tuo profilo hanno sempre la precedenza.
“Translate” nell'inbox
Senza un servizio di traduzione (e senza una tua chiave IA o DeepL come traduttore), l'inbox nasconde i pulsanti “Translate” (dalla 1.1.59). Come configurare il servizio: Gestione del self-hosting → Traduzione.
Segnale di vita e aiuto (dalla 1.1.66)
Per capire se le installazioni sono attive, dalla 1.1.66 ogni installazione in funzione invia una volta al giorno un segnale di vita anonimo a crm.the-y.at: un numero casuale per l'installazione, la versione del programma e lo stato della licenza (trial, senza chiave, free, paid, periodo di tolleranza, non valida). Dominio, nomi, indirizzi email e contenuti non vengono trasmessi; l'indirizzo IP non lo salviamo.
Disattivarlo: aggiungi questa riga al .env ed esegui docker compose up -d app worker nella cartella di installazione:
THEY_NO_TELEMETRY=1
“Can we help you?” Nella procedura guidata della tua installazione (passo “Done”, solo amministratori) puoi inserire il tuo indirizzo email: ti contattiamo noi, gratis. Se non lo inserisci, non viene inviato nulla.
Ti sei bloccato da qualche parte?
Scrivici: rispondi alla tua email di benvenuto Founder o contattaci tramite the-y.at. Ti aiutiamo con la configurazione.