# Olimpia Docs

> Documentación de Olimpia, el cloud de Buenos Aires: apps, Postgres, Redis y buckets compatibles con S3, operables desde la consola o desde tu agente por MCP.

Olimpia es una plataforma cloud que corre en Buenos Aires: hosting de apps (desde GitHub, una carpeta local o una imagen de Docker), Postgres 18 y Redis 8 administrados y buckets compatibles con S3, agrupados en proyectos. Las apps se publican en https://<subdominio>.olimpia.cc. Para operarla desde un agente, conectá el servidor MCP https://api.olimpia.dev/mcp (`claude mcp add --transport http olimpia https://api.olimpia.dev/mcp` o `codex mcp add olimpia --url https://api.olimpia.dev/mcp`) e instalá la skill con `bunx skills add olimpiacloud/olimpia-skills`. Sin OAuth, mandá `Authorization: Bearer olimpia_pat_...` al MCP o a la API REST en https://api.olimpia.dev.

## Docs

- [Preguntas frecuentes](https://docs.olimpia.dev/faq): Respuestas cortas a las dudas más comunes sobre Olimpia.

## Empezar

- [Introducción](https://docs.olimpia.dev/introduccion): Qué es Olimpia, qué podés correr hoy y cómo está pensada para personas y para agentes.
- [Primeros pasos](https://docs.olimpia.dev/primeros-pasos): Creá tu cuenta, desplegá tu primera app desde GitHub y conectale una base Postgres en cinco minutos.
- [Conceptos](https://docs.olimpia.dev/conceptos): Proyectos, recursos, deploys, nombres y cobro por uso. El vocabulario que usa Olimpia en la consola, en la API y en el servidor MCP.

## Plataforma

- [Región Buenos Aires](https://docs.olimpia.dev/plataforma/buenos-aires): Olimpia corre en Buenos Aires, en infraestructura de primer nivel. Qué significa para tu latencia, tus datos y tus usuarios.
- [Red interna](https://docs.olimpia.dev/plataforma/red-interna): Tus apps llegan a Postgres y Redis por una red privada, sin TLS que configurar y sin exponer nada a internet.
- [Seguridad](https://docs.olimpia.dev/plataforma/seguridad): Cómo protege Olimpia tu tráfico, tus secretos y tus datos, y qué controles tenés vos.

## Apps

- [Apps](https://docs.olimpia.dev/apps): Servicios web y APIs en contenedores, desplegados desde GitHub, desde una imagen de Docker o desde tu carpeta local, con HTTPS y sin cortes.
- [Deploy desde GitHub](https://docs.olimpia.dev/apps/github): CI/CD automático. Conectás un repositorio y cada push a tu rama se construye y se publica solo, sin cortes.
- [Imagen de Docker](https://docs.olimpia.dev/apps/docker): Corré cualquier imagen pública de Docker Hub, GitHub Container Registry u otro registry, sin build.
- [Subir tu carpeta](https://docs.olimpia.dev/apps/subir-codigo): Desplegá código que no está en GitHub subiendo un .tar.gz de tu carpeta, desde tu agente, un script o tu CI.
- [Builds](https://docs.olimpia.dev/apps/builds): Cómo construye Olimpia tu app con Railpack o con tu Dockerfile, qué lenguajes detecta y cómo resolver los casos raros.
- [Variables de entorno](https://docs.olimpia.dev/apps/variables): Configurá secretos y ajustes de tu app. Se guardan cifradas y llegan al build y al contenedor en el próximo deploy.
- [Dominios](https://docs.olimpia.dev/apps/dominios): Tu app responde en un subdominio de olimpia.cc y en hasta 10 dominios propios, con certificado HTTPS automático.
- [Deploys y rollbacks](https://docs.olimpia.dev/apps/deploys): Los estados de un deploy, cómo publica Olimpia sin cortes y cómo volver a una versión anterior en segundos.
- [Logs y métricas](https://docs.olimpia.dev/apps/logs-y-metricas): El log de cada build, los logs de tu app en vivo y las métricas de CPU, memoria y disco de los últimos 7 días.
- [Deploy desde tu propio CI](https://docs.olimpia.dev/apps/ci-propio): Corré tus tests en GitHub Actions, GitLab CI o cualquier pipeline y desplegá en Olimpia solo cuando pasan.
- [Si algo falla](https://docs.olimpia.dev/apps/problemas): Los errores más comunes al desplegar en Olimpia, qué significan y cómo resolverlos.

## Postgres

- [Postgres](https://docs.olimpia.dev/postgres): Postgres 18 administrado, listo en segundos, conectado a tus apps por la red interna y con backups en tu propio S3.
- [Conexión](https://docs.olimpia.dev/postgres/conexion): Conectate a tu base desde tus apps por la red interna, o desde cualquier lado por TLS con el acceso externo.
- [Explorador de datos](https://docs.olimpia.dev/postgres/explorador): Mirá tus tablas, vistas y filas desde la consola, con búsqueda y filtros, sin instalar un cliente.
- [Backups en tu S3](https://docs.olimpia.dev/postgres/backups): Programá copias automáticas de tu base en AWS S3, Cloudflare R2, Backblaze B2, MinIO o cualquier servicio compatible con S3.
- [Logs y métricas](https://docs.olimpia.dev/postgres/logs-y-metricas): Errores, advertencias y consultas lentas de tu base, y métricas de CPU, memoria, disco, conexiones y transacciones.

## Redis

- [Redis](https://docs.olimpia.dev/redis): Redis 8 persistente para caché, sesiones, colas y rate limiting, al lado de tus apps y sin perder claves por falta de memoria.
- [Conexión](https://docs.olimpia.dev/redis/conexion): Conectate a Redis por la red interna desde tus apps, o desde cualquier lado por TLS con rediss://.

## Buckets

- [Buckets](https://docs.olimpia.dev/buckets): Object storage compatible con S3 para archivos, imágenes, videos y backups, con una access key propia por bucket.
- [Credenciales y SDKs](https://docs.olimpia.dev/buckets/credenciales): Las variables de cada bucket y cómo usarlas con el AWS SDK de JavaScript, boto3, Go, la AWS CLI y rclone.
- [Acceso público](https://docs.olimpia.dev/buckets/acceso-publico): Hacé que los objetos de un bucket se puedan leer por URL, para servir imágenes, descargas o assets estáticos.

## Cuenta

- [Cuenta y acceso](https://docs.olimpia.dev/cuenta): Cómo entrás a Olimpia, cómo recuperás tu contraseña y cómo manejás tus sesiones abiertas.
- [Proyectos](https://docs.olimpia.dev/cuenta/proyectos): Agrupá apps, bases y buckets por producto, cliente o entorno, y movelos entre proyectos sin recrearlos.
- [Tokens personales](https://docs.olimpia.dev/cuenta/tokens): Creá tokens para usar la API desde scripts y CI, o para conectar agentes que no usan OAuth.
- [API REST](https://docs.olimpia.dev/cuenta/api): La API de Olimpia en api.olimpia.dev, con autenticación por token, para automatizar proyectos, apps, deploys y bases.

## Próximamente

- [Hoja de ruta](https://docs.olimpia.dev/proximamente): Lo que todavía no está habilitado en Olimpia y en qué estamos trabajando.
- [Stream](https://docs.olimpia.dev/proximamente/stream): Streaming de eventos en tiempo real entre servicios: pagos, notificaciones, logs y pipelines de datos.
- [CDN](https://docs.olimpia.dev/proximamente/cdn): Caché en el edge para servir assets estáticos y respuestas de tus apps desde el punto más cercano a cada usuario.
- [Email](https://docs.olimpia.dev/proximamente/email): Emails transaccionales desde tu dominio por API o SMTP, con SPF y DKIM configurados.
- [Réplicas de lectura](https://docs.olimpia.dev/proximamente/replicas): Réplicas de Postgres para repartir las consultas de lectura y escalar sin tocar la base principal.
- [Equipos](https://docs.olimpia.dev/proximamente/equipos): Invitá a tu equipo a Olimpia, con roles y permisos, y compartí proyectos sin compartir contraseñas.
- [Facturación](https://docs.olimpia.dev/proximamente/facturacion): Consumo del mes, facturas y medios de pago, en pesos o en dólares.
- [Nuevas regiones](https://docs.olimpia.dev/proximamente/regiones): Olimpia nace multirregión. La primera región es BUE, en Buenos Aires; las próximas se anuncian a medida que abren.

## Para agentes

- [Olimpia para agentes](https://docs.olimpia.dev/agentes): Olimpia se opera desde tu agente. Un servidor MCP con 27 herramientas para desplegar código, crear bases, correr SQL, configurar dominios y leer logs.
- [Conectar tu agente](https://docs.olimpia.dev/agentes/conectar): Cómo conectar Claude Code, Codex, Cursor, VS Code, Windsurf, Claude y otros clientes al servidor MCP de Olimpia.
- [Skill y plugin](https://docs.olimpia.dev/agentes/skill): La skill de Olimpia le enseña a tu agente a desplegar bien a la primera. El plugin de Claude Code trae la skill y el servidor MCP juntos.
- [Herramientas](https://docs.olimpia.dev/agentes/herramientas): Referencia de las 27 herramientas del servidor MCP de Olimpia, con sus parámetros y qué devuelven.
- [Flujos comunes](https://docs.olimpia.dev/agentes/flujos): Las secuencias de herramientas que usa un agente para desplegar, conectar bases, configurar dominios y arreglar un deploy roto.
- [Prompts listos](https://docs.olimpia.dev/agentes/prompts): Pedidos para copiar y pegar en tu agente, desde el primer deploy hasta migrar una app de otra nube.
- [CI y tokens](https://docs.olimpia.dev/agentes/ci-y-tokens): Usá el servidor MCP o la API sin OAuth, con un token personal, desde CI, scripts o agentes que corren sin una persona delante.
- [Autorización y límites](https://docs.olimpia.dev/agentes/seguridad): Cómo autoriza Olimpia a los agentes, cuánto duran los tokens, qué límites hay y qué reglas sigue el servidor MCP para que un agente no haga daño.
- [Esta documentación, para agentes](https://docs.olimpia.dev/agentes/docs-para-agentes): Cómo leen esta documentación los agentes. llms.txt, Markdown en cada URL, una skill generada y archivos de descubrimiento.

## Agent resources

- [llms-full.txt](https://docs.olimpia.dev/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](https://docs.olimpia.dev/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](https://docs.olimpia.dev/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://docs.olimpia.dev/openapi.json.
- [Agent skills](https://docs.olimpia.dev/.well-known/agent-skills/index.json): Agent Skills discovery index of the skills this site publishes.
- [API catalog](https://docs.olimpia.dev/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [AI catalog](https://docs.olimpia.dev/.well-known/ai-catalog.json): ARD manifest of the agent-facing resources on this site (MCP server, skills, APIs).
- [agent-readability.json](https://docs.olimpia.dev/agent-readability.json): Manifest of every agent-facing artifact on this site.
- [Sitemap](https://docs.olimpia.dev/sitemap.xml): Every indexable page URL with its last-modified date.
