Become a Measurement Source
Run our 200-line script on your server, contribute measurements, get attributed on the dashboard.

Why participate?

Single-location measurements miss what users in other regions actually experience. Your server adds a vantage point — and you get attributed on the Sources page next to the central monitor. The data is public, on-chain, and any third party can build their own analyses on it.

Register your server

3–16 chars, lowercase letters, digits, dots and hyphens.
Shown on the Sources page next to your contributions.
Approximate location of the server you'll run the script on.

How it works

Register above with your Steem account, a label, and a region. The form checks that the account exists on-chain and issues an API key on the spot. Run the participant script with that key and your measurements show up on the Sources page within 5–10 minutes.

Quick start with Docker

After getting your API key above, three commands and you're contributing:

git clone https://github.com/greece-lover/steemapps-monitor.git
cd steemapps-monitor/participant
cp .env.example .env

Open .env in your editor, paste the API key from above, save.

docker compose up -d --build

Verify measurements are flowing:

docker compose logs -f --tail 50

You'll see Flushed N (accepted=N) entries within 5 minutes. Your attribution appears on the Sources page automatically.

Without Docker

Prefer systemd over Docker? See participant/systemd-service.example in the repository for a ready-to-use unit file. About 5 minutes to install.

FAQ

Why does this need a server?

The script polls each Steem API node every 60 seconds and reports back. Browser-based measurement isn't accurate enough — server-to-server latency tells you what frontends and bots actually experience.

What does it cost?

The script uses about 30 MB RAM and 50 KB outbound bandwidth per hour. Any small VPS works.

Can I get the raw measurement data?

Yes. The full API documentation is at docs/API.md. If you need a custom data export, ask in the daily report comments.

Can I run multiple measurement points?

Yes, but use a different Steem account for each. One account = one measurement source.

What happens if my server goes offline?

Nothing bad. Your contributions just pause until the script runs again. Your registration stays active.

Can I see what data is sent?

Yes, the script is open source under MIT license and is about 200 lines of Python. Read it before installing.

How do I stop contributing?

Stop the Docker container or systemd service. To remove your registration entirely, send a Steem memo to @greece-lover.

Is custom integration possible?

Yes. The data is available via JSON API and as on-chain custom_json operations. Anyone can build their own dashboards or analyses on top. Reach out via Steem comment if you need help with integration.

Resources