Preguntas frecuentes
Respuestas cortas sobre plataformas, root, Dockerfiles, Olimpia, agentes, fallos y licencia.
¿Acropolis está listo para producción?
Es experimental. Olimpia lo usa como builder opcional con un fallback, y se prueba contra las suites de compatibilidad de otros builders: pasa completas algunas (Next.js, workspaces) y tiene resultados parciales en otras (149 de 156 casos de Railpack, 37 de 73 casos de Nixpacks). Igual, los flags, la salida y los valores por defecto pueden cambiar entre versiones 0.x. Fijá una versión y tené un builder de respaldo. Mirá Estado.
¿Corre en macOS o Windows?
No. Necesita Linux x86_64 o arm64 con glibc 2.36 o más nuevo, porque usa namespaces de montaje, PID y red, y overlayfs. En otros sistemas, usá una VM Linux o un contenedor --privileged. Mirá Instalación.
¿Necesita root?
acropolis build sí. acropolis plan no.
¿Necesita Docker?
No. No hay daemon: Acropolis descarga, buildea y pushea por su cuenta. Necesitás Docker (u otro runtime) solo para correr las imágenes o para usar la imagen del builder.
¿Y las apps con Dockerfile?
Quedan fuera del alcance: Acropolis no lee el Dockerfile, detecta el stack a partir del código fuente. Las apps que necesitan su Dockerfile seguí buildeándolas con BuildKit.
¿Mi configuración de Railpack sigue funcionando?
Sí. Acropolis lee railpack.json cuando no hay un acropolis.json, sigue el esquema y la precedencia de providers de Railpack, y lee cada ajuste primero con el prefijo ACROPOLIS_ y después con RAILPACK_. Mirá Configuración.
¿Para qué plataforma es la imagen?
Para la plataforma del host que corre el build. Buildeá en arm64 para obtener una imagen arm64.
¿Qué pasa cuando no puede buildear una app?
Termina con un código que te dice qué hacer: 1 falló el build propio de la app, 75 infraestructura (reintentá una vez), 78 la app no se puede buildear tal como está configurada, 70 un bug de Acropolis. Con 78 y 70, pasá a otro builder. Mirá códigos de salida.
¿Cómo lo uso en Olimpia?
Elegilo en Settings → Builder de tu app en Olimpia, o con builder: "acropolis" desde el servidor MCP de Olimpia. Si Acropolis no puede buildear la app, el build sigue con el Dockerfile o con Railpack. Mirá Para agentes.
¿Acropolis tiene un servidor MCP?
No. Los agentes usan la CLI acropolis, con --events json y plan --json para obtener una salida legible por máquinas, y leen esta documentación como Markdown. Olimpia tiene su propio servidor MCP para deployar ahí. Mirá Conectar.
¿Dónde guarda sus archivos?
En el home: $XDG_CACHE_HOME/acropolis, si no ~/.cache/acropolis, o lo que digan --home o ACROPOLIS_HOME. acropolis gc --max-size 20G lo recorta.
¿Cuál es la licencia?
Apache-2.0 o MIT, a tu elección. El código fuente está en github.com/olimpiacloud/acropolis.
¿Cómo reporto una vulnerabilidad?
En privado, mediante el formulario Report a vulnerability de GitHub. Mirá SECURITY.md.