Saltar al contenido

Pon tu servidor a trabajar

Usa apps en tu hardware con respaldos, monitoreo y tus propios dominios.

Solicitar acceso al runner

Conecta tu servidor

Aún no hay descargas públicas del runner; estos comandos requieren un runner ya instalado.

  • Linux con Docker Engine y Compose
  • HTTPS saliente hacia usesetup.app
  • Permiso para agregar runners

  1. Runners → Añadir runner → copiar token

    srt_El token se muestra una vez

  2. Iniciar el runner

    shell
    setup-runner run --server https://usesetup.app --token srt_…

    Límites de descarga de Docker Hub--registry-mirror mirror.gcr.io

  3. Reinicio automático con systemd

    /etc/systemd/system/setup-runner.service
    [Unit]
Description=Setup runner
Requires=docker.service
After=docker.service network-online.target

[Service]
ExecStart=/usr/local/bin/setup-runner run --server https://usesetup.app --token srt_…
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
    shell
    sudo systemctl daemon-reload && sudo systemctl enable --now setup-runner

  4. Revisa que aparezca en línea

Dales una dirección a tus apps

Apps como Vaultwarden necesitan HTTPS; los dominios propios son gratis en tus runners.

shell
setup-runner run --server https://usesetup.app --token srt_… \
  --public-host 203.0.113.7 \
  --domain apps.example.com --tls acme --acme-email ops@example.com
Sin dominio
http://192.0.2.10:20004
DNS comodín hacia tu servidor
*.apps.example.comhttps://wiki.apps.example.com
Acceso público: puertos 80 y 443
80443
Certificados de Let’s Encrypt
--tls acme
Certificados internos: márcalos como confiables en cada dispositivo
--tls internal
Dominios propios: primero se verifica el DNS
wiki.example.com

Trae las apps que ya tienes

Activa las importaciones y revisa tu selección en Runners → Traer apps de este servidor.

shell
setup-runner run --server https://usesetup.app --token srt_… --allow-import
  1. Detener la app original
  2. Copiar los datos a volúmenes nuevos
  3. Iniciar y verificar la copia
  • Compose, Portainer, CasaOS, Umbrel, contenedores
  • Solo se lee la configuración de las apps elegidas
  • Si las pruebas fallan: reiniciar la original
  • La original se conserva detenida; las carpetas nunca se borran
  • No disponible en los runners de Setup Cloud

Conoce los límites de tu servidor

Setup no cobra por usar apps ni limita su cantidad por plan; siguen aplicando la capacidad del hardware, las reglas del espacio de trabajo y los controles del plan de equipo.

  • Conexión del runner: HTTPS saliente
  • Cada app necesita una dirección propia a la que puedas acceder
  • Solicitudes de tareas: hasta 30 segundos
  • El token del runner se guarda como hash
  • Los contenedores estándar comparten el kernel del host
  • gVisor o Kata: uso automático si están instalados
  • Las compilaciones pueden acceder a tu LAN
  • Usa una VM aparte o bloquea los rangos de IP privados
  • Token revocado: el runner se cierra en la siguiente solicitud