---
name: acropolis-by-olimpia
description: "Read the Acropolis by Olimpia docs instead of answering from memory. Acropolis by Olimpia: an experimental, daemonless builder that turns an app's source code into an OCI image with no Dockerfile. A single Rust binary. Use when a task involves Acropolis by Olimpia: how it works, how to set it up or configure it, or its API."
---

# Acropolis by Olimpia

Acropolis by Olimpia: an experimental, daemonless builder that turns an app's source code into an OCI image with no Dockerfile. A single Rust binary.

This skill points you at the Acropolis by Olimpia docs, at https://acropolis.olimpia.dev/. When a task involves Acropolis by Olimpia, read the relevant page before relying on what you remember: the docs are the source of truth, and they change.

## Reading the docs

- Any page as Markdown: add `.md` to its URL (the home page is https://acropolis.olimpia.dev/index.md). Every page link below already points at the Markdown.
- [llms.txt](https://acropolis.olimpia.dev/llms.txt): every page with a one-line summary.
- [llms-full.txt](https://acropolis.olimpia.dev/llms-full.txt): every page in one file, for when you need all of it.
- [JSON API](https://acropolis.olimpia.dev/api/docs/pages.json): the page index, with each page as JSON and Markdown.

## Pages

### Get started

- [Introduction](https://acropolis.olimpia.dev/introduction.md): What Acropolis is, its experimental status, why it exists and what it supports.
- [Install](https://acropolis.olimpia.dev/install.md): Release binaries for Linux x86_64 and arm64, verified with checksums and a GitHub provenance attestation.
- [Concepts](https://acropolis.olimpia.dev/how-it-works.md): How Acropolis builds an image: the plan, the home and its caches, no builder image, segmented downloads, small runtimes and step isolation.

### Guides

- [Usage](https://acropolis.olimpia.dev/usage.md): Build an app to a registry or a tar, check the plan first, pass variables, keep caches between builders and read the output.
- [Configuration](https://acropolis.olimpia.dev/configuration.md): Configure a build with acropolis.json or railpack.json and with ACROPOLIS_ or RAILPACK_ variables.
- [Compatibility suites](https://acropolis.olimpia.dev/compatibility.md): Acropolis is tested against other builders' published test suites, not only its own apps.
- [Running in production](https://acropolis.olimpia.dev/production.md): One build per container, the builder image, privileges, network, caches and how a platform should react to each exit code.

### Reference

- [CLI reference](https://acropolis.olimpia.dev/cli.md): Every acropolis command and flag with its default, plus environment variables, output, events, info.json and exit codes.
- [Benchmarks](https://acropolis.olimpia.dev/benchmarks.md): Cold builds, rebuilds, image size and peak RAM of Acropolis against Docker and Railpack.

### Project

- [FAQ](https://acropolis.olimpia.dev/faq.md): Short answers about platforms, root, Dockerfiles, Olimpia, agents, failures and licensing.
- [Changelog](https://acropolis.olimpia.dev/changelog.md): Every notable change to Acropolis by release, from the repository's CHANGELOG.md.
- [Contributing](https://acropolis.olimpia.dev/contributing.md): Build and test Acropolis, run the plan snapshots and the e2e, and open a pull request.

### For agents

- [Acropolis for agents](https://acropolis.olimpia.dev/agents.md): How a coding agent uses Acropolis, the experimental app-to-image builder, through its CLI, its docs as Markdown, and Olimpia's MCP server when deploying on Olimpia.
- [Connect your agent](https://acropolis.olimpia.dev/agents/connect.md): There is no Acropolis MCP server: give your agent these docs as Markdown, install the binary, and use machine-readable output. For Olimpia, connect Olimpia's MCP server.
- [Tools](https://acropolis.olimpia.dev/agents/tools.md): The acropolis CLI commands an agent calls as tools, with what each prints on stdout and stderr, the JSON shapes and the exit codes.
- [Workflows](https://acropolis.olimpia.dev/agents/workflows.md): The command sequences an agent uses to check an app, build and run an image, react to failures, fix detection, keep caches in CI, and build on Olimpia.
- [Prompts](https://acropolis.olimpia.dev/agents/prompts.md): Copyable requests for a coding agent that uses Acropolis, from checking a plan to building on Olimpia.
- [Security](https://acropolis.olimpia.dev/agents/security.md): What Acropolis downloads and how it verifies it, how it handles registry credentials, what its sandbox does and doesn't protect, and rules for agents that build untrusted code.