Docker

Quick StartCopied!

Run the Docker container with your OpenAPI configuration:

docker run -p 8080:8080 -e API_REFERENCE_CONFIG='{"sources":[{"url": "https://cdn.jsdelivr.net/npm/@scalar/galaxy/dist/latest.json"}],"theme": "purple"}' scalarapi/api-reference:latest

Visit http://localhost:8080 to see your API reference.

Using Docker ComposeCopied!

Create a docker-compose.yml file:

services:
  api-reference:
    image: scalarapi/api-reference:latest
    ports:
      - "8080:8080"
    environment:
      API_REFERENCE_CONFIG: |
        {
          "sources": [
            {
              "url": "https://cdn.jsdelivr.net/npm/@scalar/galaxy/dist/latest.json"
            }
          ]
          "theme": "purple"
        }

Run with:

docker-compose up

ConfigurationCopied!

The Docker image is configured via the API_REFERENCE_CONFIG environment variable, which should contain a JSON string with your Scalar configuration.

Available TagsCopied!

• latest - Latest stable release
• {version} - Specific version (e.g., 0.2.0)

Health CheckCopied!

The container includes a health check endpoint at /health that returns OK with a 200 status code.

Environment VariablesCopied!

Configuration OptionsCopied!

For detailed configuration options, refer to the main Scalar documentation.

Building from SourceCopied!

# Clone the repository
git clone https://github.com/scalar/scalar.git
cd scalar/integrations/docker

# Build the Docker image
docker build -t scalarapi/api-reference:latest .