Amami MCP docs

By Amami Updated

Self-hosted web analytics deployment

Self-hosting gives you infrastructure control. It also gives you operational responsibility. Choose it when you need private deployment, custom retention, internal network access, compliance control, or deeper customization.

Read Installation options first if you are deciding between Cloud and a self-hosted deployment. This page covers the operating responsibilities after that decision.

Most teams should start with Cloud unless self-hosting is a real requirement.

What you operate

A production Amami-compatible deployment normally needs:

  • Application runtime or container platform.
  • PostgreSQL.
  • HTTPS reverse proxy.
  • Domain and DNS.
  • Backups and restore tests.
  • Logs and monitoring.
  • Upgrade process.
  • Optional AI provider configuration.

Minimum production checklist

  • HTTPS is enabled.
  • APP_SECRET or equivalent app secret is unique and strong.
  • Database credentials are not checked into git.
  • PostgreSQL backups are scheduled and monitored by your operations process.
  • Restore has been tested.
  • Admin access is limited.
  • Tracking script URL is stable.
  • API keys are rotated when access changes.
  • MCP clients use environment variables or local env files.

MCP with self-hosting

Use the manual configuration section of the canonical MCP and Skills installation guide to point MCP at your instance. Keep the instance URL and credentials in a local secret store; do not paste them into chat.

AI feature tradeoffs

Cloud can provide managed AI workflows. A self-hosted instance may require you to configure:

  • AI provider keys.
  • Model access.
  • Usage limits.
  • Logging and privacy controls.
  • Network egress policy.

If you do not configure AI providers, the core analytics dashboard and tracking can still be useful, but AI reports, natural language analysis, and anomaly workflows may be limited.

When not to self-host

Avoid self-hosting when:

  • You do not have someone responsible for upgrades.
  • You cannot test backups.
  • You need the fastest path to value.
  • You only need simple website analytics.
  • You want managed AI features without infrastructure work.