# plamotrack

- [plamotrack: track your Gunpla collection end to end](https://docs.gunp.la/introduction.md): plamotrack is a self-hosted kit and build tracker for Gunpla and plastic models. Track orders, inventory, and builds — and control it all from your AI assistant.
- [Install plamotrack with Docker in three minutes](https://docs.gunp.la/installation.md): Install plamotrack on your own machine or server using Docker Compose. You need Docker installed — nothing else. The whole stack starts with one command.
- [Claim your plamotrack instance on first run](https://docs.gunp.la/first-run.md): After installing, your plamotrack instance is unclaimed. Follow these steps to retrieve the one-time setup token and set your owner password.
- [Run plamotrack on your PC or home network](https://docs.gunp.la/deployment/local-and-lan.md): Access plamotrack from just your own machine, over a home network, or via a private mesh like Tailscale. Covers WEB_BIND, ALLOWED_HOSTS, and SSH tunnels.
- [Expose plamotrack to the internet with a Cloudflare Tunnel](https://docs.gunp.la/deployment/cloudflare-tunnel.md): Use a Cloudflare Tunnel to make plamotrack available anywhere without opening ports. Includes HTTPS, MCP OAuth support, and configuration for Claude web and ChatGPT.
- [Host plamotrack on a VPS with Caddy and Let's Encrypt](https://docs.gunp.la/deployment/vps-caddy.md): Deploy plamotrack on a VPS using Caddy as a reverse proxy with automatic TLS certificates from Let's Encrypt. The reference production deployment for plamotrack.
- [Use plamotrack behind your own reverse proxy](https://docs.gunp.la/deployment/reverse-proxy.md): Run plamotrack behind nginx, Traefik, nginx Proxy Manager, or any TLS proxy. Requirements and configuration checklist for a working, secure setup.
- [Authentication options in plamotrack](https://docs.gunp.la/authentication/overview.md): plamotrack supports password login, OpenID Connect (Google, Keycloak, Authentik), and personal access tokens for scripts and AI assistants. Choose the right method for your setup.
- [Sign in to plamotrack with a password](https://docs.gunp.la/authentication/password-login.md): The default auth mode for plamotrack. Set your password during first run, reset it from the command line, and manage rate limits if you get locked out.
- [Sign in with Google, Keycloak, or any OIDC provider](https://docs.gunp.la/authentication/oidc.md): Configure plamotrack to authenticate through an OpenID Connect provider. Required for Claude web and ChatGPT OAuth-based MCP connections without pasting tokens.
- [Create and use personal access tokens in plamotrack](https://docs.gunp.la/authentication/access-tokens.md): Personal access tokens let scripts, the REST API, and MCP clients like Claude Desktop authenticate with plamotrack without using your browser session.
- [The Home page and kit build pipeline in plamotrack](https://docs.gunp.la/using/home-and-pipeline.md): plamotrack tracks every kit through six stages from pre-order to complete. The Home page shows your bench, backlog, and incoming orders at a glance.
- [Managing kits and orders in plamotrack](https://docs.gunp.la/using/kits-and-orders.md): Learn how orders fan out into individual kit rows, how to record purchases and track shipping, and how to add kits you received as gifts or trades.
- [Track your tools, paints, and supplies in plamotrack](https://docs.gunp.la/using/inventory.md): plamotrack tracks four types of inventory: tools, consumables, upgrade parts, and display gear. Set low-stock alerts on consumables and record which upgrade parts went on which kit.
- [Rate and manage your retailers in plamotrack](https://docs.gunp.la/using/retailers.md): Track where you buy your kits and how each shop performs. Rate retailers on packing quality, shipping speed, and whether you'd order from them again.
- [Import and export your collection data in plamotrack](https://docs.gunp.la/using/import-export.md): Export your entire collection as a ZIP of CSVs, import it back to restore or merge, and use the starter sheet to bring in an existing spreadsheet with one row per kit.
- [Connect your AI assistant to plamotrack via MCP](https://docs.gunp.la/mcp/overview.md): plamotrack has a built-in MCP server. Connect Claude or ChatGPT to manage your collection conversationally — log orders, move kits, check stock, all by talking.
- [Connect Claude Desktop or Claude Code to plamotrack](https://docs.gunp.la/mcp/claude-desktop.md): Configure Claude Desktop or Claude Code to use plamotrack's MCP server with a personal access token. Includes config for local, LAN, and TLS-enabled instances.
- [Connect Claude.ai or ChatGPT to plamotrack via OAuth](https://docs.gunp.la/mcp/claude-web-chatgpt.md): Connect the Claude.ai or ChatGPT web apps to plamotrack's MCP server using OAuth sign-in. Requires OIDC mode and a publicly reachable HTTPS instance.
- [plamotrack MCP tools reference](https://docs.gunp.la/mcp/mcp-tools-reference.md): Full reference for the 30+ MCP tools plamotrack exposes to AI assistants. Covers kits, orders, inventory, retailers, stock, and collection summary.
- [Teach your AI Gunpla conventions with agent skills](https://docs.gunp.la/mcp/agent-skills.md): Agent skills are convention files that teach your AI assistant Gunpla naming rules, grade buckets, and series naming — so kit records come out consistent.
- [plamotrack configuration reference (.env settings)](https://docs.gunp.la/configuration/env-reference.md): All plamotrack settings live in a single .env file. Reference for every available key: database, network, authentication, MCP OAuth, and runtime options.
- [Back up and restore your plamotrack collection](https://docs.gunp.la/configuration/backups.md): Export a full archive from Settings before upgrading. Restore it with pg_restore or by re-importing the CSV archive. Covers all three restore scenarios.
- [Upgrade plamotrack to a new version](https://docs.gunp.la/configuration/upgrading.md): How to upgrade plamotrack: pull the latest code, rebuild containers, and let migrations run automatically. Includes version-specific notes for 0.4.0 and 0.3.0.
- [Troubleshoot common plamotrack issues](https://docs.gunp.la/configuration/troubleshooting.md): Fixes for the most common plamotrack issues: 421 errors, 403 on saves, password problems, port conflicts, migration failures, and MCP connection issues.