Skip to content

Configure Panel Live Server

This guide shows you how to configure Panel Live Server — the Panel web server that executes Python code snippets and renders interactive visualizations.

Prerequisites

Default Configuration

Panel Live Server runs on localhost:5077 with sensible defaults. No configuration file is required for local use.

Setting Default Description
Port 5077 Panel server port
Host localhost Server host address
Database ~/.panel-live-server/snippets/snippets.db SQLite database path
Max restarts 3 Maximum automatic restarts on failure

Configure via Environment Variables

All settings are controlled through environment variables:

export PANEL_LIVE_SERVER_PORT=9999
export PANEL_LIVE_SERVER_HOST=127.0.0.1
export PANEL_LIVE_SERVER_DB_PATH=/data/my-snippets.db
export PANEL_LIVE_SERVER_MAX_RESTARTS=5

Then start the server:

pls serve
# or, for MCP mode:
pls mcp

Configure via CLI Flags

Alternatively, pass settings directly to pls serve:

pls serve --port 9999
pls serve --host 0.0.0.0 --port 8080
pls serve --db-path /data/my-snippets.db

Run pls serve --help for the full list of options.

Running as an MCP Server

To use Panel Live Server with AI assistants, start it in MCP mode:

# stdio transport (default — for Claude Desktop, Claude Code, etc.)
pls mcp

# HTTP transport
pls mcp --transport http --host 127.0.0.1 --port 8001

# SSE transport
pls mcp --transport sse

The Panel server starts automatically in the background. You do not need to run pls serve separately.

Example: Claude Code MCP configuration

{
  "mcpServers": {
    "panel-live-server": {
      "command": "pls",
      "args": ["mcp"]
    }
  }
}

Example: Custom port via environment variable

{
  "mcpServers": {
    "panel-live-server": {
      "command": "pls",
      "args": ["mcp"],
      "env": {
        "PANEL_LIVE_SERVER_PORT": "9999"
      }
    }
  }
}

Jupyter and Remote Development Environments

In Jupyter environments (JupyterHub, VS Code Dev Containers, GitHub Codespaces), Panel Live Server automatically detects the proxy URL and externalizes visualization URLs so they are accessible from your browser.

Set the Jupyter Server Proxy URL if it is not detected automatically:

export JUPYTER_SERVER_PROXY_URL="https://your-proxy-url/proxy/5077"
pls mcp

Custom Database Location

By default the SQLite database is stored at ~/.panel-live-server/snippets/snippets.db. To use a different location:

export PANEL_LIVE_SERVER_DB_PATH=/path/to/your/snippets.db
pls serve

Or via CLI:

pls serve --db-path /path/to/your/snippets.db

Configuring Auto-Restart Behaviour

Panel Live Server automatically restarts the Panel subprocess if it becomes unhealthy, up to max_restarts times. Adjust this limit:

export PANEL_LIVE_SERVER_MAX_RESTARTS=5
pls mcp

Set to 0 to disable automatic restarts.

Troubleshooting

Port Already in Use

Change the port:

pls serve --port 5078

Or find and stop the process using the port:

# Linux / macOS
lsof -ti:5077 | xargs kill -9

# Windows
netstat -ano | findstr :5077

Server Not Responding

Check server health:

pls status

Or query the health endpoint directly:

curl http://localhost:5077/api/health

A healthy server returns {"status": "ok", ...}.

Visualizations Not Displaying

  1. Confirm the server is running: pls status
  2. Check that show is listed when you ask your AI assistant for available MCP tools
  3. Restart the MCP server if the Panel subprocess failed to start (check startup logs)

Next Steps