Beta privada · TestFlight

Guía de la beta

Todo para probar Servward de principio a fin: requisitos, instalar el agente, conectarlo, qué probar, cómo actualizarlo y cómo saber que tu servidor está sano — en Mac y Linux.

Agente v1.7.0
Unirse a la beta (TestFlight) Empezar Qué probar
QR para unirse a la beta de Servward en TestFlight O escanéalo con la cámara del iPhone

Antes de empezar

Requisitos

Cuatro cosas y en 5 minutos estás monitorizando tu servidor.

📱

iPhone

Con iOS reciente. Instala la beta desde tu enlace de TestFlight.

🖥

Un servidor

Un Mac (launchd) o un Linux con systemd donde correrá el agente.

🌐

Acceso remoto

Tailscale (lo más fácil) o un túnel Cloudflare ya montado para llegar a tu servidor desde el móvil.

🧰

git

Necesario en el servidor para instalar y actualizar. En Mac viene con las Command Line Tools.

Paso 1

Instala el agente

Un solo comando en tu servidor, Mac o Linux. La pestaña Guía de la app te da este mismo comando y te acompaña.

curl -fsSL https://raw.githubusercontent.com/INVESTMENTPERPLE/servward-agent/main/install.sh | bash

Al final, el instalador imprime un QR y un código. Escanea el QR con la cámara del iPhone y la app queda configurada — con la URL incluida si el servidor ya tiene Tailscale. Re-ejecuta el mismo comando cuando quieras actualizar: conserva tu token y ajustes.

Paso 2

Conecta la app

Escanea el QR del instalador

Apunta la cámara del iPhone al QR que salió en el terminal: se abre Servward con nombre, topics y token — y la URL ya incluida si el servidor tiene Tailscale. Confirma y listo.

¿Sin QR? Pega el código

Copia el código del instalador en Ajustes → «Pegar configuración». Si falta la URL: por Tailscale http://100.x.x.x:2586 o tu dominio Cloudflare https://….

Permite notificaciones

Acéptalas cuando la app lo pida — sin esto no recibirás las alertas de caída.

¿Segundo servidor?

Escanea el QR desde el primero para añadirlo sin teclear nada.

Tu misión

Qué probar

Recorre estas funciones y cuéntame cualquier fallo o roce.

📊

Métricas en vivo

CPU, RAM y disco moviéndose en la pestaña Control.

❤️

Salud

Abre Salud: puntuación general y SMART por disco.

🔄

Reiniciar un servicio

Reinícialo y confirma que vuelve a arrancar.

⌨️

Comando personalizado

Crea y ejecuta un comando guardado.

🔔

Alerta de caída

Apaga el servidor y espera la notificación + Live Activity.

🧩

Widget

Añade el widget a la pantalla de inicio y comprueba que refresca.

v1.7.0

Novedades — pruébalas

Lo nuevo de esta versión. Ponles cariño: es lo que más nos interesa que revientes.

🔄

Actualizar el agente desde la appNuevo

Ajustes → «Actualizar agente del servidor». Mac y Linux, sin abrir el terminal.

💽

Salud de discos (SMART)Nuevo

Estado real de cada disco. Requiere smartmontools en el servidor.

📈

Histórico de métricasNuevo

Gráfica con la evolución de CPU, RAM y disco en el tiempo.

⬆️

Actualizaciones del sistemaNuevo

Ver y aplicar updates del sistema (apt / brew) desde la app.

📷

Añadir servidor por QRNuevo

Escanea y listo, sin teclear URL ni token.

⏱

Botón en la Live ActivityNuevo

«Reintentar» desde la Isla Dinámica y la pantalla bloqueada.

🩺

Salud por umbralesNuevo

Puntuación más justa: no penaliza la RAM cacheada normal de macOS.

🌍

App en inglés e italianoNuevo

Interfaz traducida al 100%.

Mantente al día

Actualizar el agente

Cuando salga un build nuevo de la app, sincroniza el servidor. Dos formas:

Opción A · recomendado

Desde la app

Ajustes → «Actualizar agente del servidor». Descarga la última versión y la reinicia por ti, en cualquier OS. Sin terminal.

Opción B

Desde el servidor

Vuelve a ejecutar el instalador. Actualiza en el sitio y conserva token y ajustes.curl -fsSL https://raw.githubusercontent.com/INVESTMENTPERPLE/servward-agent/main/install.sh | bash

¿Va todo bien?

Cómo saber que está sano

🏷

Chip de versión

En Control debe poner v1.7.0, igual que la app. Si no, desliza para refrescar (solo se actualiza con Control abierto).

📊

Métricas moviéndose

Si las barras cambian, la app está hablando con tu servidor.

❤️

Salud + SMART

Puntuación alta y discos en verde (SMART necesita smartmontools).

🚫

Sin alerta roja

Ninguna alerta de «servidor caído» = la conexión está sana.

🖥

Desde el servidor

En el servidor, ntfyctl status muestra si el agente y el broker están vivos.

Si algo falla

Solución de problemas

La app no conecta
Comprueba que Tailscale está activo (o el túnel Cloudflare arriba) y que usas el puerto 2586. Prueba la URL en el navegador del móvil.
No llegan las alertas
Acepta las notificaciones en Ajustes de iOS → Servward. Verifica que el servidor tiene conexión a internet.
SMART no aparece
Instala smartmontools en el servidor: brew install smartmontools o apt install smartmontools.
El chip sigue en una versión vieja
Actualiza el agente (Ajustes → Actualizar), abre la pestaña Control y desliza para refrescar.
El comando de instalar falla
Asegúrate de tener git instalado. En Mac: xcode-select --install.
¿Algo no va y no sabes qué?
En el servidor: ntfyctl doctor — comprueba servicios, puerto, token y Tailscale, y te dice el remedio de cada fallo.
¿Cómo lo desinstalo?
En el servidor: ntfyctl uninstall — para y elimina los servicios y, si quieres, también el código y la configuración.

Tranquilidad

Privacidad y seguridad

Servward es self-hosted: la app habla directamente con tu servidor (Tailscale/Cloudflare), sin nube intermedia ni cuentas. Tu token da control total del agente — guárdalo como una contraseña y puedes rotarlo cuando quieras. Detalles en la Política de privacidad.

Tu feedback importa

Reportar

Cualquier fallo, texto raro o paso confuso: mándalo por el feedback de TestFlight (con captura si puedes). Gracias por probar 🙌

Private beta · TestFlight

Beta guide

Everything to test Servward end to end: requirements, installing the agent, connecting it, what to test, how to update it, and how to know your server is healthy — on Mac and Linux.

Agent v1.7.0
Join the beta (TestFlight) Get started What to test
QR to join the Servward beta on TestFlight Or scan it with your iPhone camera

Before you start

Requirements

Four things and you're monitoring your server in 5 minutes.

📱

iPhone

On a recent iOS. Install the beta from your TestFlight link.

🖥

A server

A Mac (launchd) or a Linux box with systemd to run the agent.

🌐

Remote access

Tailscale (easiest) or a Cloudflare Tunnel already set up so the phone can reach your server.

🧰

git

Needed on the server to install and update. On Mac it ships with the Command Line Tools.

Step 1

Install the agent

One command on your server, Mac or Linux. The app's Guide tab gives you this same command and walks you through it.

curl -fsSL https://raw.githubusercontent.com/INVESTMENTPERPLE/servward-agent/main/install.sh | bash

At the end, the installer prints a QR and a code. Scan the QR with your iPhone camera and the app gets configured — with the URL included if the server already runs Tailscale. Re-run the same command anytime to update: it keeps your token and settings.

Step 2

Connect the app

Scan the installer's QR

Point your iPhone camera at the QR shown in the terminal: Servward opens with name, topics and token — and the URL already included if the server runs Tailscale. Confirm and you're in.

No QR? Paste the code

Copy the installer's code into Settings → "Paste configuration". If the URL is missing: over Tailscale http://100.x.x.x:2586 or your Cloudflare domain https://….

Allow notifications

Accept them when the app asks — without this you won't get down alerts.

Second server?

Scan the QR from the first one to add it with zero typing.

Your mission

What to test

Run through these and report any bug or rough edge.

📊

Live metrics

CPU, RAM and disk moving on the Control tab.

❤️

Health

Open Health: overall score and per-disk SMART.

🔄

Restart a service

Restart one and confirm it comes back.

⌨️

Custom command

Create and run a saved command.

🔔

Down alert

Shut the server down and wait for the notification + Live Activity.

🧩

Widget

Add the widget to your Home Screen and check it refreshes.

v1.7.0

What's new — test these

This version's new stuff. Hammer it: this is what we most want you to break.

🔄

Update the agent from the appNew

Settings → "Update the server agent". Mac and Linux, no terminal.

💽

Disk health (SMART)New

Real per-disk status. Requires smartmontools on the server.

📈

Metrics historyNew

A chart with CPU, RAM and disk over time.

⬆️

System updatesNew

See and apply system updates (apt / brew) from the app.

📷

Add a server by QRNew

Scan and done — no typing URL or token.

⏱

Live Activity buttonNew

"Retry" from the Dynamic Island and Lock Screen.

🩺

Threshold-based healthNew

Fairer score: it no longer penalizes macOS's normal cached RAM.

🌍

App in English & ItalianNew

Fully translated interface.

Stay current

Update the agent

When a new app build ships, sync the server side. Two ways:

Option A · recommended

From the app

Settings → "Update the server agent". Pulls the latest and restarts it for you, any OS. No terminal.

Option B

From the server

Re-run the installer. Updates in place and keeps token and settings.curl -fsSL https://raw.githubusercontent.com/INVESTMENTPERPLE/servward-agent/main/install.sh | bash

Is it all good?

How to know it's healthy

🏷

Version chip

Control should read v1.7.0, matching the app. If not, pull to refresh (only updates while Control is open).

📊

Metrics moving

If the bars change, the app is talking to your server.

❤️

Health + SMART

High score and disks in green (SMART needs smartmontools).

🚫

No red alert

No "server down" alert = the connection is healthy.

🖥

From the server

On the server, ntfyctl status shows whether the agent and broker are alive.

If something breaks

Troubleshooting

The app won't connect
Check Tailscale is up (or the Cloudflare tunnel is running) and that you're using port 2586. Try the URL in the phone's browser.
Alerts don't arrive
Allow notifications in iOS Settings → Servward. Make sure the server has internet.
SMART doesn't show
Install smartmontools on the server: brew install smartmontools or apt install smartmontools.
The chip still shows an old version
Update the agent (Settings → Update), open the Control tab and pull to refresh.
The install command fails
Make sure git is installed. On Mac: xcode-select --install.
Something's off and you don't know what?
On the server: ntfyctl doctor — checks services, port, token and Tailscale, and tells you the fix for each failure.
How do I uninstall it?
On the server: ntfyctl uninstall — stops and removes the services and, if you want, the code and configuration too.

Peace of mind

Privacy & security

Servward is self-hosted: the app talks directly to your server (Tailscale/Cloudflare), with no cloud in between and no accounts. Your token gives full control of the agent — keep it like a password, and you can rotate it anytime. Details in the Privacy Policy.

Your feedback matters

Reporting

Any bug, odd wording or confusing step: send it via TestFlight feedback (with a screenshot if you can). Thanks for testing 🙌