Il tuo server di sincronizzazione

Cosa ottieni

FastMemo Server è l'alternativa self-hosted a Google Firebase per la Sincronizzazione Cloud. Un solo container Docker, un solo file di database.

• Privato

  Le note vengono cifrate sui tuoi dispositivi prima di uscirne. Il server le conserva, ma non può leggerle.

• In tempo reale

  Una modifica arriva sugli altri dispositivi in circa un secondo, anche in una nota aperta.

• A prova di offline

  Un dispositivo che non raggiunge il server tiene da parte le modifiche e le invia appena può.

• Con una dashboard

  Dispositivi, spazio, letture, scritture e cancellazioni al giorno, avvisi e backup con un clic.

Cosa ti serve

• Un computer sempre acceso: un PC, un NAS, una VPS o un Raspberry Pi 3, 4 o 5 con il sistema a 64 bit.
• Docker, che fa girare il server in una scatola tutta sua.
• Circa 15 minuti. Niente programmazione: copi qualche comando.

Avvia il server

Sul computer che lo ospiterà, apri un terminale (su Windows: PowerShell) e segui questi passi.

1. 1

   Installa Docker

   Installa Docker Desktop (si apre in una nuova scheda) su Windows o macOS, oppure Docker Engine su Linux e Raspberry Pi.

2. 2

   Scarica il server

   Copia il server in una cartella chiamata fastmemo-server e crea il suo file di impostazioni.

   Copia

   git clone https://github.com/ontech7/fastmemo-server.git
   cd fastmemo-server
   cp .env.example .env

3. 3

   Avvialo

   Il server ora è attivo sulla porta 8787. Ripartirà da solo dopo un riavvio.

   Copia

   docker compose up -d

4. 4

   Trova la chiave di accesso

   È la password che i tuoi dispositivi usano per collegarsi. Il server ne ha creata una al primo avvio: cercala in quello che stampa questo comando e conservala in un posto sicuro.

   Copia

   docker compose logs fastmemo

5. 5

   Apri la dashboard

   Vai su http://localhost:8787 con un browser su quel computer e inserisci la chiave di accesso: vedrai i dispositivi, le operazioni al giorno e i backup.

Raggiungilo dal telefono

Usa un indirizzo https://: la web app e l'app Windows raggiungono solo quelli, e tiene privati i titoli delle note e le credenziali dei dispositivi su qualsiasi rete. Scegli il modo che fa per te:

Tailscale (il più semplice)

Installa Tailscale (si apre in una nuova scheda) sul server e su ogni dispositivo, ed entra con lo stesso account. Poi, sul server:

sudo tailscale serve --bg 8787

Stampa l'indirizzo del tuo server, tipo https://raspberrypi.your-tailnet.ts.net. Se ti chiede di abilitare i certificati HTTPS, segui il link che mostra: è un clic. Infine, imposta TRUST_PROXY=true nel file .env e rilancia docker compose up -d.

Coolify

Crea una risorsa dal repository fastmemo-server con il build pack Docker Compose e il file compose /docker-compose.coolify.yml. Assegna al servizio il tuo dominio seguito da :8787 (per esempio https://notes.example.com:8787) e fai il deploy: Coolify si occupa dell'HTTPS e genera le chiavi (Environment Variables).

Caddy (VPS e dominio)

Fai puntare il dominio al server, scrivilo nel file .env e avvia il server insieme a Caddy, che ottiene da solo il certificato HTTPS:

# in .env: DOMAIN=notes.example.com
docker compose -f docker-compose.caddy.yml up -d

Collega FastMemo

Su ogni dispositivo:

1. 1

   Apri Impostazioni → Sincronizzazione Cloud e attiva Abilita sincronizzazione Cloud.

2. 2

   In Sincronizza con, scegli FastMemo Server.

3. 3

   Compila Indirizzo del server (https://…) e Chiave di accesso, poi tocca Salva impostazioni.

4. 4

   Sul primo dispositivo scegli una Password di crittografia e annota la Chiave di recupero che ti mostra. Gli altri dispositivi chiedono la stessa password.

Backup e aggiornamenti

• Fai un backup dalla dashboard: un solo file con tutto. Le note restano cifrate, ma contiene anche i titoli e la chiave di accesso: tienilo al sicuro.
• Hai perso un telefono? Rimuovilo dalla dashboard (o da Gestisci dispositivi nell'app): il suo accesso si blocca subito.
• Per aggiornare il server, esegui questi due comandi nella sua cartella:

git pull
docker compose up -d --build

Buono a sapersi