bluesky-selfhost-env
Herramienta para auto-alojar entornos Bluesky/atproto completos en un solo host usando Docker Compose. Incluye scripts Makefile, parches de compatibilidad con upstream recientes y soporte para SSL, DNS y gestión de servicios como PDS, BGS y Social App.
Ficha actualizada 26 sept 2026, 14:54 · upstream 26 sept 2026, 14:20 · release sin release detectada
Qué es bluesky-selfhost-env
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio facilita el despliegue de una instancia completa de la red social Bluesky (protocolo atproto) en infraestructura propia mediante Docker Compose. Orquesta múltiples componentes esenciales, incluyendo PDS, BGS, Social App, Jetstream y Ozone, aplicando parches necesarios para mantener compatibilidad con cambios recientes en el código fuente upstream. La herramienta incluye scripts Makefile que automatizan operaciones críticas como la configuración de variables de entorno, generación de secretos, despliegue de contenedores y gestión de certificados SSL (auto-firmados o Let's Encrypt).
La solución está diseñada para simplificar la administración del stack atproto, permitiendo configuraciones reproducibles y un mapeo mínimo entre dominios FQDN, reverse proxy y contenedores. Sin embargo, requiere intervención manual para configurar DNS, instalar certificados raíz en el host y navegador, y ajustar variables de entorno específicas como DOMAIN o INDIGO_SSRF_PUBLIC_ONLY_SCENARIO debido a cambios en la política de seguridad upstream.
- Auto-alojamiento completo de Bluesky en VPS o infraestructura on-premise
- Desarrollo y pruebas de aplicaciones atproto con acceso local a APIs
- Implementación de moderación de contenido mediante integración con Ozone
- Generación de feeds personalizados utilizando el Feed Generator
- Recuperación de funcionalidades eliminadas o parches para versiones específicas de upstream
- Orquestación completa de servicios (PDS, BGS, Social App) en un solo host vía Docker Compose
- Incluye scripts Makefile para automatizar despliegue y configuración inicial
- Parches aplicados para compatibilidad con cambios recientes de upstream (SSRF, Proxy headers)
- Soporte para certificados SSL auto-firmados o Let's Encrypt integrado
- Integración nativa con herramientas externas como Ozone y Feed Generator
- Funcionalidad de chat directo (DM) no implementada en la versión actual
- Dependencia de versiones específicas de upstream que requieren parches manuales
- Alta complejidad inicial por necesidad de configuración DNS y certificados SSL
- Cambios frecuentes en upstream pueden romper funcionalidades si no se actualizan los parches
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Configurar registros A para el dominio y subdominios (*.domain). Instalar certificados CA o usar Let's Encrypt. Definir variables de entorno como DOMAIN y asof antes de ejecutar make docker-pull. Ejecutar make getCAcert e installCAcert para certificados auto-firmados. Verificar respuestas DNS con dig antes de iniciar contenedores.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.