Server Overview#
vl-convert serve exposes VlConvert over HTTP. Use it when several applications share one rendering service, when the calling application is not written in Python or Rust, or when rendering should run outside the caller’s process.
Start a Local Server#
$ vl-convert serve --port 3000
The server API provides these endpoint groups:
Path |
Purpose |
|---|---|
|
Compile and convert Vega-Lite input |
|
Convert Vega input |
|
Convert existing SVG |
|
List and inspect themes |
|
Build browser JavaScript bundles |
|
Liveness, readiness, and version information |
|
Interactive API documentation and the OpenAPI document |
See Quick Start for a complete request and Server API for every endpoint.
By default the server binds to loopback, allows 30 seconds per request, accepts request bodies up to 50 MB, and accepts browser requests from loopback origins only. It does not require authentication, enforce render-time budgets, cap concurrent requests, or hide error details until you configure those options.
Server API and Admin API#
The server API provides conversion and health routes. The optional admin API uses a separate port or Unix socket for runtime management, so a deployment can expose rendering without exposing configuration, budget, font-cache, or worker controls.
See Admin Server API for runtime management and Authentication for API access controls.
Deploying the Server covers TCP ports and Unix sockets, health checks, and shutdown. Render-Time Budgets explains render-time budgets, and Server Logging describes request logs.