The-Y CRM · Guida

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)

Cosa ti serve

→ 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

  1. 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).

  2. 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.

  3. 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

Caso A

🟢 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.

Caso B

🧩 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.

Caso C

⚙️ 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>
Importante: il tuo dominio deve essere servito in HTTPS: per sicurezza i cookie di accesso sono “secure”. Con il semplice HTTP l'accesso non funziona. Pannelli e certbot gestiscono il certificato in automatico. Unica eccezione dalla 1.1.58: un server solo nella tua rete, senza dominio (rete di casa).

Ultimo passo: accedi e inserisci la licenza

  1. 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.

  2. 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.

✅ Aggiornamenti e backup
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.sh
Senza 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

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.

Limiti (1.1.58): solo IPv4; non sul server di standby; chiamate WhatsApp e fail2ban per SIP non sono preconfigurati; senza una tua musica d'attesa la coda resta in silenzio. Tutti i punti: problemi noti · nel dettaglio: 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.

  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
Dopo, i dispositivi si registrano di nuovo. I softphone nel browser lo fanno da soli in pochi secondi. I telefoni da scrivania e le app softphone solo al prossimo intervallo di registrazione (spesso 1–60 minuti); fino ad allora non sono raggiungibili. Se serve, riavvia il dispositivo o l'app. Il CRM ripristina da solo “Do not disturb”.

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)

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)

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.

Cosa non funziona via http (i browser lo consentono solo con https): telefono nel browser e videoriunioni, notifiche push sul telefono, aggiungere l'app al telefono, alcuni pulsanti “Copy” (seleziona e copia il testo a mano) e tutto ciò che richiede un indirizzo https pubblico: WhatsApp, Facebook e Instagram, l'accesso con Google, il collegamento di una casella Microsoft 365. Le email con IMAP/SMTP e password funzionano.

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.