Knowledge base

Riferimento comandi Zinnector®

Ogni comando Zinnector® esattamente come riportato da zinnector --help — argomenti, flag e valori predefiniti, un esempio eseguibile e il relativo output stampato — generato direttamente dalla stessa interfaccia CLI per non discostarsi dalla versione installata.

Ogni comando supportato da Zinnector® 0.1.6 — 43 in totale, esattamente come elencati da zinnector --help — con le relative opzioni, un esempio eseguibile e ciò che dovreste visualizzare. Questa pagina è generata direttamente dalla CLI stessa, pertanto non può essere in disaccordo con lo strumento installato; se un comando qui presente manca sul vostro computer, eseguite npm install -g zinnector@latest.

Prima di iniziare

Installatelo con npm install -g zinnector su Node 24 o versioni successive, quindi verificate l'installazione con zinnector --version e zinnector --help. La guida introduttiva illustra i primi cinque minuti; questa pagina è il riferimento a cui tornare.

Ogni comando accetta -h, --help. Queste opzioni globali vanno inserite prima del nome del comando:

opzione	cosa fa
`-V, --version`	stampa la versione
`--profile <name>`	utilizza un profilo di credenziali denominato

I comandi

`zinnector new`

Crea l'impalcatura di un progetto WordPress che potete eseguire immediatamente.

zinnector new [options] [name]

argomento	obbligatorio	che cos'è
`name`	no	directory in cui creare il progetto e nome del progetto — obbligatorio tranne con --here

opzione	cosa fa	predefinito
`-t, --template <kind>`	uno tra: site, plugin, theme	`"site"`
`--php <version>`	versione di PHP con cui sviluppare	`"8.3"`
`--wp <version>`	versione di WordPress per il runtime locale	`"latest"`
`--runtime <name>`	playground o docker	`"playground"`
`--here`	esegue lo scaffolding nella directory corrente anziché in una nuova

Esempio

zinnector new my-site

Cosa vede — acquisito — 0.1.2 su Linux

Created my-site  ·  site
──────────────────────────

  + .gitignore
  + README.md
  + wp-content/mu-plugins/000-zinnector-dev.php
  + wp-content/plugins/.gitkeep
  + wp-content/themes/.gitkeep
  + zinnector.json

  php        8.3
  wordpress  latest
  runtime    playground

→ run it:
    cd my-site
    zinnector dev

→ then, when you have a hosting slot:
    zinnector link     # point it at a site
    zinnector check    # pre-flight before you push
    zinnector push

`zinnector dev`

Esegua questo progetto localmente — Docker non richiesto.

zinnector dev [options]

opzione	descrizione	predefinito
`--php <version>`	versione di PHP da eseguire (5.2–8.5 su playground, 7.4–8.5 su docker)
`--wp <version>`	versione di WordPress
`-p, --port <port>`	porta su cui gestire le richieste
`--runtime <name>`	playground (predefinito) o docker
`--login`	accedi automaticamente come amministratore	`true`
`--no-login`	non accedere automaticamente
`--once`	avvia, segnala cosa è in esecuzione, quindi arresta
`--yes`	installa il runtime locale senza chiedere
`--reset-runtime`	elimina il runtime installato e reinstallalo
`-v, --verbose`	mostra l'output del runtime stesso

Esempio

cd my-site
zinnector dev

Ciò che vedete — acquisito — 0.1.2. La prima esecuzione chiede una volta di scaricare il runtime di WordPress (~570 MB); passate --yes per saltare la domanda

my-site  ·  WordPress Playground (WASM, no Docker)
───────────────────────────────────────────────────

  serving    a WordPress project
  from       /home/you/my-site
  php        8.3
  wordpress  latest

✔ running at http://127.0.0.1:9400
  admin: http://127.0.0.1:9400/wp-admin  (already signed in)

  Ctrl-C to stop

`zinnector login`

Acceda — con il Suo account nel browser oppure con una chiave API.

zinnector login [options]

opzione	azione	predefinito
`--profile <name>`	memorizza con un profilo denominato (predefinito: default)
`--api <url>`	URL di base dell'API	`"https://api.zinndigital.com"`
`--api-key`	incolla una chiave API specifica per l'organizzazione invece di accedere con il proprio account
`--issuer <url>`	il servizio di accesso	`"https://auth.zinndigital.com/realms/zinn"`
`--no-browser`	stampa il link di accesso senza tentare di aprire un browser

Esempio

zinnector login

Cosa vede — la chiave viene digitata al prompt, mai nella riga di comando. In CI, la invii tramite pipe: echo "$ZINN_API_KEY" | zinnector login --profile ci

Sign in to Zinn Digital®  ·  https://api.zinndigital.com
────────────────────────────────────────────────────

  API key: ••••••••••••••••••••••••••••

✔ signed in as you@example.com (Acme Ltd) — profile “default”
→ next: zinnector sites

`zinnector logout`

Dimentica un accesso memorizzato.

zinnector logout [options]

opzione	cosa fa	predefinito
`--profile <name>`	quale profilo dimenticare (predefinito: default)

Esempio

zinnector logout

Cosa vedi

✔ signed out of profile “default”

`zinnector whoami`

Mostra con quale utente è connessa questa CLI e a cosa può accedere.

zinnector whoami [options]

opzione	descrizione	predefinito
`--profile <name>`	usa un profilo denominato
`--scopes`	elenca i permessi associati a una chiave API
`--json`	output leggibile da una macchina

Esempio

zinnector whoami --scopes

Cosa vede — acquisito da un'esecuzione reale della versione 0.1.5 in produzione il 2026-09-14; domini, ID e link monouso sono stati sostituiti


Signed in  ·  https://api.zinndigital.com
──────────────────────────────────────────
account        you@example.com
as             a person, signed in through the browser
organisations  8 — listed below
mode           live
credential     profile “default”

  · Example Org  owner · 01a00000-0000-7000-8000-000000000000
  · Example Org· 01a00001-0000-7000-8000-000000000001
  · Example Org· 01a00002-0000-7000-8000-000000000002
  · Example Org· 01a00003-0000-7000-8000-000000000003
  · Example Org· 01a00004-0000-7000-8000-000000000004
  · Example Org· 01a00005-0000-7000-8000-000000000005
  · Example Org· 01a00006-0000-7000-8000-000000000006
  · Example Org· 01a00007-0000-7000-8000-000000000007

  scopes belong to API keys — a signed-in person acts with their ROLE in each organisation (shown above).

`zinnector sites`

Elenca i siti che questa chiave può vedere.

zinnector sites [options]

opzione	cosa fa	predefinito
`--json`	output leggibile dalla macchina
`--status <status>`	solo i siti in questo stato

Esempio

zinnector sites

Cosa vede — acquisito da un'esecuzione reale della versione 0.1.5 in produzione il 2026-09-14; domini, ID e link monouso sono stati sostituiti


Sites  ·  12
─────────────
domain          status  php      target  id
example-2.com   active  php —    fleet   01a00000-0000-7000-8000-000000000000
example-3.com   active  php —    fleet   01a00001-0000-7000-8000-000000000001
example-4.com   active  php —    fleet   01a00002-0000-7000-8000-000000000002
example-5.com   active  php 8.5  fleet   01a00003-0000-7000-8000-000000000003
example-6.com   active  php —    fleet   01a00004-0000-7000-8000-000000000004
example.com     active  php 8.4  fleet   01a00005-0000-7000-8000-000000000005
example-7.com   active  php —    fleet   01a00006-0000-7000-8000-000000000006
example-8.com   active  php 8.5  fleet   01a00007-0000-7000-8000-000000000007
example-9.com   active  php 8.5  fleet   01a00008-0000-7000-8000-000000000008
example-10.com  active  php 8.5  fleet   01a00009-0000-7000-8000-000000000009
example-11.com  active  php 8.5  fleet   01a00010-0000-7000-8000-000000000010
example-12.com  active  php 8.5  fleet   01a00011-0000-7000-8000-000000000011

`zinnector status`

Tutto ciò che la piattaforma sa su un sito.

zinnector status [options] [site]

argomento	obbligatorio	che cos'è
`site`	no	un ID sito, dominio primario o nome — per impostazione predefinita il sito collegato in zinnector.json

opzione	cosa fa	predefinito
`--json`	output leggibile dalla macchina

Esempio

zinnector status example.com

Cosa vede — acquisito da un'esecuzione reale della versione 0.1.5 in produzione il 2026-09-14; domini, ID e link monouso sono stati sostituiti


example.com  ·  01a00000-0000-7000-8000-000000000000
────────────────────────────────────────────────────────────────────────
status         active
product line   footprint_free
stack          wordpress
region         fsn1
deploy target  fleet
plan           PBN 10

● PHP
version        8.4
can switch to  8.5, 8.4, 8.3, 8.2, 8.1, 8.0, 7.4

● Quota
disk      188 MB used of 500.0 GB
files     6,313 of 2,000,000
database  1 MB

● Deploy
status         building
target         fleet
repository     —
commit         —
live url       —
last deployed  2026-09-14T01:29:26.991511Z

● WordPress
version     7.1
up to date  yes
multisite   no

`zinnector share`

Fornite a una persona l'accesso a UN solo sito — uno sviluppatore, un designer, un cliente.

zinnector share [options] <site> <email>

argomento	obbligatorio	descrizione
`site`	sì	il sito da condividere — un id, dominio primario o nome
`email`	sì	a chi concedere l'accesso — riceverà un invito via email se non ha ancora un account

opzione	funzione	predefinito
`--role <role>`	cosa possono fare: viewer, editor, manager
`--reason <text>`	motivo della richiesta — conservato insieme all'autorizzazione per la traccia di controllo
`--until <date>`	termine automatico dell'accesso (AAAA-MM-GG); omettere per mantenere l'accesso fino alla revoca
`--json`	output leggibile da una macchina

Esempio

zinnector share example.com dev@agency.test --role editor --reason "rebuild the checkout"

Cosa vede — la forma esatta stampata dal comando, dalla sorgente (W40-DEVTOOL le ha aggiunte dopo l'ultima acquisizione di questo file); i Suoi domini, ID e date saranno diversi

Shared example.com  ·  01a03f39-730a-7dc4-84b0-5d4f7582dd04
────────────────────────────────────────────────────────────

✔ invited dev@agency.test as editor
  They have no account yet, so an invitation has been emailed. Until they
  sign in and accept it they can see nothing; the moment they do, the site is theirs.

→ what they do next, on their own machine:
    npm i -g zinnector && zinnector login   # sign in as themselves
    zinnector clone example.com   # pull the files down

`zinnector collaborators`

Chi ha ricevuto l'accesso a un sito e se ha accettato.

zinnector collaborators [options] [site]

argomento	obbligatorio	che cos'è
`site`	no	un ID sito, dominio primario o nome — per impostazione predefinita il sito collegato in zinnector.json

opzione	cosa fa	predefinito
`--json`	output leggibile dalla macchina

Esempio

zinnector collaborators example.com

Cosa vedete — acquisito da un'esecuzione reale di 0.1.5 in produzione il 2026-09-14; domini, id e link monouso sostituiti. la forma esatta stampata dal comando, dall'origine (W40-DEVTOOL li ha aggiunti dopo l'ultima acquisizione di questo file); i vostri domini, id e date saranno diversi


Access to example.com  ·  3
───────────────────────────────────────────────────────────
who              role    status   ends  why                                          grant
dev@agency.test  viewer  revoked  —     Example Org— revoked immediately after       01a00000-0000-7000-8000-000000000000
dev@agency.test  viewer  revoked  —     Example Org— revoked at the end of the walk  01a00001-0000-7000-8000-000000000001
dev@agency.test  editor  revoked  —     Example Org— revoked at the end of the walk  01a00002-0000-7000-8000-000000000002

`zinnector unshare`

Revocare l'accesso di una persona a un sito — tramite e-mail o ID di concessione (grant id).

zinnector unshare [options] <site> <who>

argomento	obbligatorio	descrizione
`site`	sì	il sito a cui revocare l'accesso — un id, dominio primario o nome
`who`	sì	la persona da rimuovere — il suo indirizzo email oppure il grant id da zinnector collaborators

opzione	cosa fa	predefinito
`--yes`	non chiedere conferma

Esempio

zinnector unshare example.com dev@agency.test --yes

Cosa vede — la forma esatta stampata dal comando, dalla sorgente (W40-DEVTOOL le ha aggiunte dopo l'ultima acquisizione di questo file); i Suoi domini, ID e date saranno diversi

✔ withdrew the invitation to dev@agency.test

`zinnector invitations`

Gli inviti che La attendono e accettarne uno.

zinnector invitations [options] [command]

Esempio

zinnector invitations

Ciò che vedete — acquisito da un'esecuzione reale di 0.1.5 in produzione il 2026-09-14; domini, ID e link monouso sostituiti. La forma esatta stampata dal comando, dall'origine (W40-DEVTOOL li ha aggiunti dopo l'ultima acquisizione di questo file); i vostri domini, ID e date saranno diversi; senza sottocomando viene eseguito list


Invitations  ·  0
──────────────────

● nothing waiting for you

`zinnector invitations list`

Inviti indirizzati all'account con cui ha effettuato l'accesso.

zinnector invitations list [options]

opzione	cosa fa	predefinito
`--json`	output leggibile dalla macchina

Esempio

zinnector invitations list


Invitations  ·  0
──────────────────

● nothing waiting for you

`zinnector invitations accept`

Accetti un invito: il sito sarà Suo non appena l'operazione sarà completata.

zinnector invitations accept [options] <id>

argomento	obbligatorio	descrizione
`id`	sì	l'id dell'invito da zinnector invitations — è sufficiente un suo prefisso univoco

Esempio

zinnector invitations accept 01a03f39-9c11-7b02-a7e0-2e4d0c5f1b77

Cosa vede — la forma esatta stampata dal comando, dalla sorgente (W40-DEVTOOL le ha aggiunte dopo l'ultima acquisizione di questo file); i Suoi domini, ID e date saranno diversi

✔ you now have access to example.com

`zinnector link`

Punti questo progetto a uno slot di hosting (e ne connetta il repository).

zinnector link [options] [site]

| argomento | obbligatorio | che cos'è |\n|---|---|---|\n| site | no | un ID del sito, dominio primario o nome — per impostazione predefinita il sito collegato in zinnector.json |\n\n| opzione | cosa fa | predefinito |\n|---|---|---|\n| --repo <owner/name> | collega questo repository al sito sulla piattaforma | |\n| --provider <name> | l'account collegato tramite cui effettuare il deploy: github_app, github o gitlab (impostazione predefinita: quello collegato dalla Sua organizzazione) | |\n| --branch <name> | ramo da cui un push effettua il deploy | |\n| --no-repo | scrive solo zinnector.json; non modifica la piattaforma | |\n\nEsempio

zinnector link example.com --repo acme/example-site --branch main

Cosa vedi

✔ this project deploys to example.com (01a03f39-730a-7dc4-84b0-5d4f7582dd04)
  written to zinnector.json — commit it so everyone deploys to the same slot
✔ the platform will deploy acme/example-site (main)
→ next: zinnector check

`zinnector pull`

Scaricate i file di un sito ospitato in questo progetto per lo sviluppo locale — ed eseguite di nuovo per risincronizzare.

zinnector pull [options] [site]

argomento	obbligatorio	descrizione
`site`	no	un ID sito, dominio principale o nome — l'impostazione predefinita è il sito collegato in zinnector.json

opzione	azione	predefinito
`--via <seam>`	auto (predefinito), git o backup	`"auto"`
`--fresh`	crea un nuovo backup invece di usare l'ultimo (consuma uno slot on-demand)
`--max-age <hours>`	accetta l'ultimo backup se è più recente di questo intervallo	`"24"`
`--full`	l'intera radice del documento, core di WordPress incluso (predefinito: solo wp-content)
`--no-uploads`	escludi wp-content/uploads (file multimediali)
`--no-database`	escludi il database del sito — acquisisci solo i file
`--live-config`	scrivi anche wp-config.php — contiene le credenziali del database LIVE
`--clean`	svuota wp-content prima dell'estrazione, in modo da riflettere le eliminazioni sul sito
`--dry-run`	indica cosa accadrebbe e interrompi l'operazione
`--yes`	non chiedere conferma

Esempio

zinnector pull

Cosa vedi

Pull example.com  ·  01a03f39-730a-7dc4-84b0-5d4f7582dd04
─────────────────────────────────────────────────────────────

● via git — the site syncs to its own repository and this is a clone of it
✔ fast-forwarded 3 commits 4f1c2a9b → 9d2e7c14

● not synced, and why
  ✖ database                     the local playground has its own; the site's is not copied
  ✖ offloaded media              objects in storage are not in the site's files
  ✖ anything outside the repository  only wp-content syncs

→ next: zinnector dev

`zinnector clone`

Crea un progetto locale da un sito ospitato: clona il relativo repository o scarica i suoi file.

zinnector clone [options] <site> [dir]

argomento	obbligatorio	descrizione
`site`	sì	il sito ospitato da copiare: un id, un dominio principale o un nome
`dir`	no	directory da creare: il valore predefinito è il dominio principale del sito

opzione	cosa fa	predefinito
`--via <seam>`	auto (predefinito), git o backup	`"auto"`
`--fresh`	esegue un nuovo backup invece di utilizzare l'ultimo disponibile
`--full`	l'intera directory root dei documenti, incluso il core di WordPress
`--no-uploads`	tralascia wp-content/uploads (file multimediali)
`--no-database`	tralascia il database del sito — acquisisce solo i file
`--live-config`	scrive anche wp-config.php — contiene le credenziali del database LIVE
`--yes`	non chiedere conferma

Esempio

zinnector clone client.example.com

Cosa vedi

Clone client.example.com  ·  client.example.com
──────────────────────────────────────────────────────

✔ wrote client.example.com/zinnector.json (php 8.3, wordpress 6.7.1)
● via backup — the site does not sync to a repository
✔ downloaded 214 MB and extracted wp-content

● not synced, and why
  ✖ database                     the local playground has its own; the site's is not copied
  ✖ offloaded media              objects in storage are not in the site's files
  ✖ wp-config.php                holds the live database credentials (--live-config to write it)
  ✖ WordPress core               the runtime supplies the version the slot runs (--full to take it)

→ next: zinnector dev

→ run it:
    cd client.example.com
    zinnector dev

`zinnector sync`

Sincronizzazione bidirezionale tra i file live di un sito e il suo repository.

zinnector sync [options] [command]

Esempio

zinnector sync --help

Cosa vede — senza alcun sottocomando, zinnector sync <site> equivale a sync status

Usage: zinnector sync [options] [command]

two-way sync between a site's live files and its repository

  site → repository   zinnector sync run   commits the live files and pushes the branch
  repository → site   zinnector push       builds the branch and publishes it

`zinnector sync status`

Stato della sincronizzazione bidirezionale e le sue ultime esecuzioni.

zinnector sync status [options] [site]

argomento	obbligatorio	che cos'è
`site`	no	un ID sito, dominio primario o nome — per impostazione predefinita il sito collegato in zinnector.json

opzione	cosa fa	predefinito
`--json`	output leggibile dalla macchina

Esempio

zinnector sync status example.com

Cosa vede — acquisito da un'esecuzione reale di 0.1.4 su un sito di prova il 2026-09-12; il dominio e gli ID sono sostituiti con valori di esempio

Two-way sync — example.com
──────────────────────────

repository   acme/example-site (main)
available    yes
sync         on
state        synced
last sync    2026-09-12T22:51:41.539832Z
note         Started from acme/example-site@main.

run        files       commit         when
synced     2 changed   da85d73cef5f   2026-09-12T22:52:10.117301Z

`zinnector sync on`

Attivi la sincronizzazione bidirezionale (di per sé non trasmette nulla).

zinnector sync on [options] [site]

argomento	obbligatorio	descrizione
`site`	no	ID del sito, dominio principale o nome — l'impostazione predefinita è il sito collegato in zinnector.json

opzione	cosa fa	predefinito
`--subdir <path>`	sincronizza solo questa sottodirectory del sito
`--json`	output leggibile dalla macchina

Esempio

zinnector sync on example.com

Ciò che vede — richiede un repository collegato al Suo account GitHub; non invia nulla da solo

✔ two-way sync is on

Two-way sync — example.com
…
→ next: zinnector sync run

`zinnector sync off`

Disattivi la sincronizzazione bidirezionale.

zinnector sync off [options] [site]

argomento	obbligatorio	descrizione
`site`	no	ID del sito, dominio principale o nome — l'impostazione predefinita è il sito collegato in zinnector.json

opzione	cosa fa	predefinito
`--subdir <path>`	sincronizza solo questa sottodirectory del sito
`--json`	output leggibile dalla macchina

Esempio

zinnector sync off example.com

Cosa vedi

✔ two-way sync is off

`zinnector sync run`

Esegua subito il commit dei file live del sito nel rispettivo repository.

zinnector sync run [options] [site]

argomento	obbligatorio	che cos'è
`site`	no	un ID sito, dominio primario o nome — per impostazione predefinita il sito collegato in zinnector.json

opzione	cosa fa	predefinito
`--json`	output leggibile dalla macchina

Esempio

zinnector sync run example.com

Cosa vede — acquisito da un'esecuzione reale di 0.1.4 su un sito di prova il 2026-09-12; il dominio e gli ID sono sostituiti con valori di esempio. Un'esecuzione che il repository ha già superato viene invece contrassegnata come HELD: non viene inviato né sovrascritto nulla, il comando termina con codice 1 e indica il passaggio successivo

✔ committed 2 changed files da85d73cef5f

Two-way sync — example.com
…
→ next: git pull in your clone

`zinnector sync resolve`

Cancella una sincronizzazione sospesa scegliendo quale lato prevale.

zinnector sync resolve [options] [site]

argomento	obbligatorio	descrizione
`site`	no	un id del sito, dominio primario o nome — il valore predefinito è il sito collegato in zinnector.json

opzione	cosa fa	predefinito
`--keep <side>`	site (esegue il commit del sito in cima) o repository (scarta le modifiche non sincronizzate del sito)
`--yes`	non chiedere
`--json`	output leggibile dalla macchina

Esempio

zinnector sync resolve example.com --keep repository --yes

Cosa si vede — acquisito da un'esecuzione reale di 0.1.4 su un sito di prova il 2026-09-12; il dominio e gli id sono sostituiti con valori di esempio. Senza --yes chiede prima, e rifiuta categoricamente quando non c'è un terminale in cui chiedere

✔ kept the repository

Two-way sync — example.com
…
state        synced

`zinnector check`

Confrontate questo progetto con lo slot su cui state per eseguire la distribuzione.

zinnector check [options] [site]

argomento	obbligatorio	che cos'è
`site`	no	un ID sito, un dominio principale o un nome — il valore predefinito è il sito collegato in zinnector.json

opzione	cosa fa	predefinito
`--probe`	avvia il runtime locale e MISURA il suo php, anziché fidarsi di zinnector.json
`--all`	mostra anche i controlli superati
`--strict`	fallisce anche quando non è stato possibile verificare qualcosa
`--json`	output leggibile da una macchina

Esempio

zinnector check

Cosa vede — acquisito da un'esecuzione reale della versione 0.1.5 in produzione il 2026-09-14; domini, ID e collegamenti monouso sostituiti — l'esecuzione ha rilevato una mancata corrispondenza reale (PHP 8.3 nel progetto rispetto a 8.4 nello slot), che è l'intero scopo del comando

→ reading the slot
  size excludes: .git

Pre-flight — example.com  ·  01a00000-0000-7000-8000-000000000000
────────────────────────────────────────────────────────────────────────

  local  php 8.4  3 files, 0.0 MB
  slot   php 8.4  target fleet
  local php is the version DECLARED in zinnector.json — run with --probe to measure it

  ? unknown   local php extensions could not be enumerated
      try zinnector dev --once

  ? unknown   wordpress versions could not be compared
      No WordPress version found in the working copy.
      try zinnector status

  7 passed  ·  2 could not be checked

`zinnector push`

Verifica preliminare, invio dei commit e distribuzione.

zinnector push [options] [site]

argomento	obbligatorio	che cos'è
`site`	no	un ID del sito, dominio principale o nome — il valore predefinito è il sito collegato in zinnector.json

opzione	cosa fa	predefinito
`-f, --force`	esegui il deploy anche quando i controlli preliminari rilevano problemi
`--skip-checks`	non eseguire affatto i controlli preliminari
`--probe`	misura il runtime locale durante i controlli preliminari invece di affidarti a zinnector.json
`--no-wait`	avvia il deploy ed esci senza monitorarlo
`--no-git`	non eseguire git push; esegui il deploy di ciò che è già presente sulla piattaforma
`--dry-run`	esegui tutte le operazioni tranne il deploy

Esempio

zinnector push

Cosa vedi

Deploy to example.com  ·  01a03f39-730a-7dc4-84b0-5d4f7582dd04
───────────────────────────────────────────────────────────────

✔ pre-flight: 8 passed  ·  0 to look at  ·  2 could not be checked
→ pushing main (4f1c2a9b add the contact form)
✔ pushed
● deploy 7c0e… started — watching
✔ deployed 4f1c2a9b in 48s

  status    success
  commit    4f1c2a9b
  url       https://example.com

`zinnector deploy`

Eseguite nuovamente il deployment di ciò che la piattaforma ha già, senza inviare.

zinnector deploy [options] [site]

| argomento | obbligatorio | descrizione |\n|---|---|---|\n| site | no | un ID sito, dominio primario o nome — il valore predefinito è il sito collegato in zinnector.json |\n\n| opzione | azione | predefinito |\n|---|---|---|\n| --no-wait | attiva ed esci | |\n\nEsempio

zinnector deploy example.com

Cosa vede — acquisito da un'esecuzione reale della versione 0.1.5 in produzione il 2026-09-14; domini, ID e link monouso sono stati sostituiti


Redeploy example.com  ·  01a00000-0000-7000-8000-000000000000
────────────────────────────────────────────────────────────────────────
→ starting the deploy
✔ deploy started

`zinnector deploys`

Cronologia dei rilasci di un sito.

zinnector deploys [options] [site]

argomento	obbligatorio	che cos'è
`site`	no	un ID sito, dominio primario o nome — l'impostazione predefinita è il sito collegato in zinnector.json

opzione	cosa fa	predefinito
`--json`	output leggibile dalla macchina
`-n, --limit <n>`	quanti mostrarne	`"10"`

Esempio

zinnector deploys example.com

Cosa vede — acquisito da un'esecuzione reale della versione 0.1.5 in produzione il 2026-09-14; domini, ID e link monouso sono stati sostituiti


Deploys — example.com  ·  2
───────────────────────────────────────────────────────────
status  commit  branch  trigger  started                      message
live    —       —       manual   2026-09-14T09:06:39.685554Z  —
live    —       —       manual   2026-09-14T01:29:20.196957Z  —

`zinnector php`

Visualizzare o cambiare la versione di PHP di un sito.

zinnector php [options] [version]

argomento	obbligatorio	descrizione
`version`	no	la versione di PHP a cui passare il sito, ad es. 8.4 — omettere per mostrare quella corrente

opzione	cosa fa	predefinito
`-s, --site <site>`	id del sito o dominio
`--list`	elenca le versioni offerte dalla piattaforma
`--json`	output leggibile da una macchina

Esempio

zinnector php 8.3 --site example.com

Ciò che vedete — acquisito da un'esecuzione reale di 0.1.5 in produzione il 2026-09-14; domini, ID e collegamenti monouso sostituiti. senza versione mostra quella corrente; --list mostra ciò che la piattaforma offre per la linea di prodotti di questo sito


PHP — example.com
──────────────────────────────────────────────────────
version        8.4
can switch to  8.5, 8.4, 8.3, 8.2, 8.1, 8.0, 7.4

`zinnector quota`

Utilizzo di disco, file e database rispetto a quanto concesso dal piano.

zinnector quota [options] [site]

argomento	obbligatorio	che cos'è
`site`	no	un ID sito, dominio primario o nome — per impostazione predefinita il sito collegato in zinnector.json

opzione	cosa fa	predefinito
`--json`	output leggibile dalla macchina

Esempio

zinnector quota example.com

Cosa vede — acquisito da un'esecuzione reale della versione 0.1.5 in produzione il 2026-09-14; domini, ID e link monouso sono stati sostituiti


Quota — example.com
────────────────────────────────────────────────────────
disk used      188 MB
disk limit     500.0 GB
disk granted   500 GB  (per_site)
files used     6,313
file limit     2,000,000
database       1 MB

  “limit” is what is enforced today; “granted” is what the plan says.

`zinnector db`

Dimensioni del database e link monouso a phpMyAdmin e al gestore file.

zinnector db [options] [site]

argomento	obbligatorio	che cos'è
`site`	no	un ID sito, dominio primario o nome — per impostazione predefinita il sito collegato in zinnector.json

opzione	cosa fa	predefinito
`--json`	output leggibile dalla macchina

Esempio

zinnector db example.com

Cosa vede — acquisito da un'esecuzione reale di 0.1.5 in produzione il 2026-09-14; domini, ID e link monouso sono stati sostituiti. I link a phpMyAdmin e al gestore file sono monouso e scadono; non li incolli da nessuna parte


Database — example.com
───────────────────────────────────────────────────────────
size    1 MB
tables  14

  single-use links, valid for one visit:
  phpMyAdmin    https://pma.example.com/signon.php?t=<single-use>
  file manager  https://files.example.com/signon.php?t=<single-use>

`zinnector logs`

Segua in tempo reale i log di accesso e di errore di un sito.

zinnector logs [options] [site]

| argomento | obbligatorio | che cos'è |\n|---|---|---|\n| site | no | un id del sito, un dominio principale o un nome — il valore predefinito è il sito collegato in zinnector.json |\n\n| opzione | cosa fa | predefinito |\n|---|---|---|\n| --access | solo il registro degli accessi | |\n| --error | solo il registro degli errori | |\n| --build | invece il registro di compilazione della distribuzione più recente | |\n| --json | output leggibile dalla macchina | |\n\nEsempio

zinnector logs example.com --error

Cosa vede — acquisito da un'esecuzione reale di 0.1.5 in produzione il 2026-09-14; domini, id e link monouso sostituiti. --access per il registro degli accessi, --build per il registro di compilazione dell'ultimo deployment (un sito non compilato da un provider di compilazione mostra i passaggi del deployment stesso); senza flag vengono mostrati entrambi i registri del sito, e un registro che non è stato possibile leggere lo segnala invece di apparire vuoto


Error log — example.com
────────────────────────────────────────────────────────────

2026-09-14 11:06:07.153643 [NOTICE] [1929978] [T0] [config:vhost:zcaffb6eec5abbdab03fb9b2d62a15:epsr:lsphp-zcaffb6eec5abbdab03fb9b2d62a15]'Process Limit' probably is too low, adjust the limit to: 640.
2026-09-14 11:06:37.873060 [INFO] [1929982] [T0] [lsphp-zcaffb6eec5abbdab03fb9b2d62a15] add child process pid: 1933036, procinfo: 0x5555561cfe30

`zinnector wp`

Esegua un comando WP-CLI consentito su un sito.

zinnector wp [options] [command...]

| argomento | obbligatorio | che cos'è |\n|---|---|---|\n| command... | no | il comando WP-CLI e i relativi argomenti, ad es. plugin list — ometterlo con --commands |\n\n| opzione | cosa fa | predefinito |\n|---|---|---|\n| -s, --site <site> | id del sito o dominio | |\n| --commands | elenca ciò che la piattaforma eseguirà | |\n| --json | output leggibile dalla macchina | |\n\nEsempio

zinnector wp plugin list --site example.com

Cosa si vede — acquisito da un'esecuzione reale di 0.1.5 in produzione il 2026-09-14; domini, ID e collegamenti monouso sostituiti. la allow-list è fornita dalla piattaforma — zinnector wp --commands la stampa

name	status	update	version	update_version	auto_update
akismet	inactive	none	5.7.2		off
hello	inactive	none	1.7.2		off
imunify-security	active	none	4.1.0		off
litespeed-cache	active	none	7.9.1		off
redis-cache	active	none	2.8.0		off
zinn-cache	active	none	1.2.2		off
object-cache.php	dropin				off

`zinnector backup`

Elenca e crea backup del sito.

zinnector backup [options] [command]

Esempio

zinnector backup list example.com

Cosa si vede — acquisito da un'esecuzione reale di 0.1.5 in ambiente di produzione il 2026-09-14; domini, ID e link monouso sono stati sostituiti. Il comando backup da solo stampa i relativi sottocomandi; vedere backup list e backup now di seguito


Backups — example.com  ·  3
───────────────────────────────────────────────────────────
status  taken                        size    id
stored  2026-09-14T09:06:39.918280Z  4.7 MB  01a00000-0000-7000-8000-000000000000
stored  2026-09-14T01:29:20.403161Z  36 MB   01a00001-0000-7000-8000-000000000001
stored  2026-09-14T01:29:15.898099Z  36 MB   01a00002-0000-7000-8000-000000000002

daily backups   on
retention       30 days
off-site copy   yes
on-demand left  2 of 3

`zinnector backup list`

Elenca i backup di un sito e ciò che il relativo piano include.

zinnector backup list [options] [site]

argomento	obbligatorio	che cos'è
`site`	no	un ID sito, dominio primario o nome — per impostazione predefinita il sito collegato in zinnector.json

opzione	cosa fa	predefinito
`--json`	output leggibile dalla macchina

Esempio

zinnector backup list example.com

Cosa vede — acquisito da un'esecuzione reale della versione 0.1.5 in produzione il 2026-09-14; domini, ID e link monouso sono stati sostituiti


Backups — example.com  ·  3
───────────────────────────────────────────────────────────
status  taken                        size    id
stored  2026-09-14T09:06:39.918280Z  4.7 MB  01a00000-0000-7000-8000-000000000000
stored  2026-09-14T01:29:20.403161Z  36 MB   01a00001-0000-7000-8000-000000000001
stored  2026-09-14T01:29:15.898099Z  36 MB   01a00002-0000-7000-8000-000000000002

daily backups   on
retention       30 days
off-site copy   yes
on-demand left  2 of 3

`zinnector backup now`

Eseguite un backup su richiesta.

zinnector backup now [options] [site]

argomento	obbligatorio	descrizione
`site`	no	un id del sito, dominio primario o nome — per impostazione predefinita è il sito collegato in zinnector.json

Esempio

zinnector backup now example.com

Cosa vedi

✔ backup started — zinnector backup list example.com shows it when it completes

`zinnector domains`

Elenca i domini visibili da questa chiave.

zinnector domains [options]

opzione	cosa fa	predefinito
`--json`	output leggibile dalla macchina

Esempio

zinnector domains

Cosa vede — acquisito da un'esecuzione reale della versione 0.1.5 in produzione il 2026-09-14; domini, ID e link monouso sono stati sostituiti


Domains  ·  1
──────────────
domain       status     ownership  renewal        expires
example.com  connected  connected  no auto-renew  —

`zinnector dns`

Leggere e modificare i record DNS.

zinnector dns [options] [command]

Esempio

zinnector dns list example.com

Cosa vede — acquisito da un'esecuzione reale di 0.1.5 in ambiente di produzione il 2026-09-14; domini, ID e link monouso sostituiti. dns da solo visualizza i propri sottocomandi; vedere dns list, dns add e dns rm di seguito


DNS — example.com  ·  1 records
────────────────────────────────────────
type  name          value               ttl
TXT   w4357-verify  zinn-w4357-updated  ttl 3600

`zinnector dns list`

Elenca i record DNS di un dominio.

zinnector dns list [options] <domain>

argomento	obbligatorio	che cos'è
`domain`	sì	il dominio, per nome o id

opzione	cosa fa	predefinito
`--type <type>`	solo i record di questo tipo
`--json`	output leggibile dalla macchina

Esempio

zinnector dns list example.com

Cosa vede — acquisito da un'esecuzione reale della versione 0.1.5 in produzione il 2026-09-14; domini, ID e link monouso sono stati sostituiti


DNS — example.com  ·  1 records
────────────────────────────────────────
type  name          value               ttl
TXT   w4357-verify  zinn-w4357-updated  ttl 3600

`zinnector dns add`

Crea un record DNS.

zinnector dns add [options] <domain> <type> <name> <value>

argomento	obbligatorio	descrizione
`domain`	sì	il dominio, per nome o id
`type`	sì	tipo di record: A, AAAA, CNAME, MX, TXT, SRV, …
`name`	sì	il nome del record — @ per il dominio stesso, oppure un'etichetta di sottodominio
`value`	sì	a cosa punta il record — un indirizzo, un hostname o testo

opzione	cosa fa	predefinito
`--ttl <seconds>`	time to live	`"3600"`
`--priority <n>`	priorità, per MX e SRV
`--proxied`	instrada tramite la CDN
`-y, --yes`	non chiedere conferma

Esempio

zinnector dns add example.com TXT _acme "token" --ttl 300

Cosa si vede — il record viene mostrato e confermato prima di essere scritto; passare --yes per saltare la domanda

Add a DNS record to example.com
───────────────────────────────

  type   TXT
  name   _acme
  value  "token"
  ttl    300

  create it? [y/N] y
✔ created TXT _acme

`zinnector dns rm`

Elimina un record DNS.

zinnector dns rm [options] <domain> <recordId>

argomento	obbligatorio	descrizione
`domain`	sì	il dominio, per nome o id
`recordId`	sì	l'id del record, così come viene stampato da zinnector dns list

opzione	cosa fa	predefinito
`-y, --yes`	non chiedere

Esempio

zinnector dns rm example.com rec_7f3a

Cosa vedi

⚠ deleting A @ 203.0.113.10 from example.com
  delete it? [y/N] y
✔ deleted

`zinnector mail`

Elenca i servizi di posta.

zinnector mail [options]

opzione	cosa fa	predefinito
`--json`	output leggibile dalla macchina

Esempio

zinnector mail

Cosa vede — acquisito da un'esecuzione reale della versione 0.1.5 in produzione il 2026-09-14; domini, ID e link monouso sono stati sostituiti


Mail services  ·  0
────────────────────

● no mail services

`zinnector bulk`

Eseguite un'operazione su più siti (cache_purge, malware_scan, sitemap, block_ip).

zinnector bulk [options] <operation>

argomento	obbligatorio	descrizione
`operation`	sì	cosa eseguire su ogni sito selezionato: cache_purge, malware_scan, sitemap o block_ip

opzione	cosa fa	predefinito
`--all`	ogni sito visibile da questa chiave
`--site <site...>`	siti specifici, per id o dominio
`--status <status>`	ogni sito in questo stato
`-y, --yes`	non chiedere
`--json`	output leggibile da una macchina

Esempio

zinnector bulk cache_purge --all

Cosa vede — acquisito da un'esecuzione reale della versione 0.1.5 in produzione il 2026-09-14; domini, id e link monouso sostituiti. una sola chiamata alla piattaforma per l'intera selezione, non una per sito; la selezione viene prima mostrata e confermata


Bulk cache_purge  ·  1 sites
─────────────────────────────

·   example.com

→ running cache_purge
✔ cache_purge accepted for 1 sites

  The platform runs this asynchronously; results appear per site in the dashboard.

`zinnector ai`

Chieda all'assistente di Zinn Digital®, con questo progetto come contesto.

zinnector ai [options] <question...>

argomento	obbligatorio	descrizione
`question...`	sì	ciò che desidera chiedere, in parole semplici — l'uso delle virgolette è facoltativo

opzione	funzione	predefinito
`-s, --site <site>`	chiede informazioni su un sito specifico
`--org <id>`	l'organizzazione a nome della quale chiedere, se il Suo account appartiene a più di una
`--no-context`	non invia alcuna informazione sul progetto locale
`--json`	output leggibile dalla macchina

Esempio

zinnector ai "why is my deploy failing?"

Cosa vede — acquisito da un'esecuzione reale della versione 0.1.5 in produzione il 2026-09-14; domini, ID e collegamenti monouso sono stati sostituiti. L'assistente risponde nella lingua dell'ACCOUNT — la lingua di questo account è l'arabo, quindi la risposta acquisita è in arabo a una domanda in inglese

→ thinking

Zinn Digital® assistant
────────────────────────────

  هذا مشروع WordPress تم إنشاؤه بواسطة Zinnector® (مُهيّأ على PHP 8.4، أحدث
  إصدار WordPress، وبيئة تشغيل playground)؛ لتشغيله محلياً، انتقل إلى مجلده
  وشغّل الأمر: cd <اسم-المشروع> ثم zinnector dev، وسيقوم بتشغيل موقع WordPress
  حقيقي على جهازك دون الحاجة إلى Docker.

  sources:
    · https://zinndigital.com/kb/zinnector-getting-started
    · https://zinndigital.com/kb/zinnector-local-development

`zinnector mcp`

Esegua un bridge stdio verso il server MCP ospitato — per Claude Desktop e altri client esclusivamente locali.

zinnector mcp [options]

Esempio

ZINN_MCP_TOKEN=zmcp_live_… zinnector mcp

Ciò che vedete — avviato DA un client AI come Claude Desktop, mai manualmente — comunica in MCP su stdin e stdout. Verificato da Claude Code 2.1.270 sul server live in data 2026-09-12

zinnector 0.1.4: MCP bridge to https://api.zinndigital.com/v1/mcp

Variabili di ambiente

variabile	effetto
`ZINNECTOR_TOKEN`	una chiave API, utilizzata al posto di un profilo salvato — in questo modo la CI si autentica
`ZINNECTOR_API`	URL di base dell'API (predefinito `https://api.zinndigital.com`)
`ZINNECTOR_DEBUG=1`	stampa le tracce dello stack e l'output dell'installer di runtime
`ZINNECTOR_CACHE_DIR`	dove vengono conservati il runtime di WordPress ed eventuali Node gestiti (predefinito `~/.cache/zinnector`)
`ZINNECTOR_CONFIG_DIR`	dove risiede il file di profilo della chiave API (predefinito `~/.config/zinnector`)
`NO_COLOR`	disabilita il colore

Codici di uscita

0 successo · 1 un riscontro o un rifiuto · 70 un errore interno · 77 autenticazione o autorizzazione · 78 Node non supportato.

Tutta la documentazione per sviluppatori →

Le ultime novità dal blog

Cosa abbiamo scritto su hosting, SEO e gestione di siti su larga scala.

SEO e link building dal livello di hosting: Il punto di vista di un operatore per il 2026

Come l'hosting modella l'indicizzazione e l'equità dei link nel 2026: mantenere le pagine indicizzate, verificare i domini datati prima di svilupparli, link building senza tracce per i motori di ricerca e una visione onesta di ciò che l'infrastruttura può e non può fare per la SEO.

21 luglio 2026

Leggi l'articolo →

Rendere WordPress veloce e sicuro: checklist per prestazioni e plugin

Una lista di controllo pratica per un WordPress veloce e sicuro: memorizzazione nella cache a livello di server, una cache degli oggetti per sito, la manciata di plugin che vale la pena eseguire, il mantenimento dello stack aggiornato e le pagine WooCommerce da non memorizzare mai nella cache.

20 luglio 2026

Leggi l'articolo →

Come scegliere un hosting web gestito nel 2026: guida per l'acquirente

Cosa distingue davvero un buon hosting gestito da una macchina economica con pannello di controllo — migrazioni, backup, isolamento, caching reale e scalabilità trasparente — e come valutarlo prima di impegnarsi.

19 luglio 2026

Leggi l'articolo →

Leggi il blog →

Hai ancora bisogno di aiuto?

Il supporto è incluso in ogni piano, il servizio è attivo 24 ore al giorno e potete scriverci in una qualsiasi delle nostre 58 lingue: vi risponderemo nella vostra.

Contatta l'assistenza → Tutti gli articoli →