# Install on Linux Install the GroupDocs.Metadata MCP server on Linux with the setup bootstrapper (PowerShell plus Docker, or the .NET 10 SDK and its native libraries) and the guided installer. Install the GroupDocs.Metadata MCP server on **Linux** with the setup bootstrapper — it installs PowerShell (`pwsh`) plus Docker, or the .NET 10 SDK and its native libraries — and then the guided installer: ```bash git clone https://github.com/groupdocs/GroupDocs.Mcp.Installer.git cd GroupDocs.Mcp.Installer bash setup/linux.sh --channel docker pwsh ./install-groupdocs-mcp.ps1 -Interactive ``` ## Prerequisites `setup/linux.sh` automates Debian/Ubuntu (apt + packages.microsoft.com), idempotently; add `--check` to report without installing. Other distros get the official documentation links printed instead of guessed package names. * **Always:** PowerShell 7 (`pwsh`) — runs the installer scripts. * **Docker channel (recommended):** docker engine (`sudo apt-get install -y docker.io`); the script adds you to the `docker` group — **log out/in** (or `newgrp docker`) before the first run. * **NuGet channel:** .NET 10 SDK (`sudo apt-get install -y dotnet-sdk-10.0`) plus native graphics dependencies: ```bash sudo apt-get install -y --no-install-recommends \ libgdiplus libfontconfig1 ``` ## Install **Recommended — the installer:** ```bash pwsh ./install-groupdocs-mcp.ps1 -Channel docker \ -Products metadata -Clients claude-desktop -Verify ``` **Manual alternatives:** ```bash # Docker channel - native deps bundled in the image (amd64 + arm64): docker run --rm -i --user "$(id -u):$(id -g)" \ -v $(pwd)/documents:/data \ ghcr.io/groupdocs-metadata/metadata-net-mcp:latest # NuGet channel (requires .NET 10 SDK + the native deps above): dnx GroupDocs.Metadata.Mcp --yes ``` The image runs as a non-root user (uid 1654), and a mounted folder keeps its host owner — `--user "$(id -u):$(id -g)"` runs the container as you, so it can write cleaned and updated files into your folder. MCP client configs are JSON and run no shell, so `$(id -u)` is not expanded there. Put the numbers in directly (`id -u` and `id -g` print them): `"--user", "1000:1000"` after `"-i"`. Client config locations on Linux: Claude Desktop `~/.config/Claude/claude_desktop_config.json`, VS Code user-level `~/.config/Code/User/mcp.json` — full list in [Register in AI clients]({{< ref "metadata/net/mcp/install-in-ai-clients.md" >}}). ## Verify ```bash pwsh ./verify-groupdocs-mcp.ps1 ``` A passing run completes the MCP handshake (six tools listed) and — when a document sits in your storage folder — a real `get_document_info` call. Headless servers: the docker channel plus `-EmitCompose` gives you a `docker-compose.yml` for supervised operation. ## Linux-specific troubleshooting * **`DllNotFoundException: libgdiplus`** in tool responses — the NuGet-channel native deps are missing; run the `apt-get install` line above, or switch to the docker channel where they are bundled. * **`docker: permission denied`** — your user is not in the `docker` group yet; `newgrp docker` or re-login. * **`Permission denied` when the server saves into the mounted folder** — the container runs as uid 1654; add `--user "$(id -u):$(id -g)"` (numbers in JSON configs). * **Fonts look wrong in cleaned and updated files** — install `ttf-mscorefonts-installer` (the setup script pre-accepts its EULA via debconf). Installing on a different OS? [Windows]({{< ref "metadata/net/mcp/windows-installation.md" >}}) · [macOS]({{< ref "metadata/net/mcp/macos-installation.md" >}})