Self-Hosted Measure v0.12.x Migration Guide

Migration guide for self-hosted Measure v0.12.x. Modifies Slack integration, a dedicated MCP/Agent endpoint & configuration migration.

Use this guide only when you are on less than v0.12.0 and upgrading to v0.12.x.

Steps mentioned in this document will cause downtime.

Follow these steps when upgrading to 0.12.x. There is some downtime involved. During the downtime SDKs would receive a 503 Service Unavailable when sending sessions. Once the upgrade is complete, ingestion should resume normally. SDKs will retry sending unsent sessions automatically.

1. Shutdown all Measure services

SSH into the VM where Measure is hosted.

cd ~/measure/self-host

sudo docker compose -f compose.yml -f compose.prod.yml --profile init --profile migrate down --remove-orphans

2. Perform the upgrade

Visit Releases page to capture the latest tag matching the v[MAJOR].[MINOR].[PATCH] format. For example, v0.12.0.

cd ~/measure

git reset --hard # only applies if you have local modifications

git fetch --tags

# replace <git-tag> with the chosen tag. example: v0.12.0
git checkout <git-tag>

3. Migrate configurations

cd ~/measure/self-host

sudo ./config.sh --production --ensure

You'll be prompted to enter the agent endpoint, enter a value like https://measure-agent.yourcompany.com.

4. Re-configure Slack

Skip this step if you don't wish to use Slack integration.

Starting with v0.12.x, the Measure Slack app needs additional permissions & configurations. Visit the Set up Slack guide for instructions.

5. Configure Measure Agent & MCP

Skip this step if you don't wish to use Measure MCP/Agent.

Starting with v0.12.x, the Measure MCP endpoint URL format has changed. Additionally, you can set up the Measure Agent as well. Visit the Set up Measure Agent guide for instructions. After the setup reauthorize the remote MCP server in your coding agents.

6. Start Measure services

sudo ./install.sh

Migration Guide for `v0.12.x`