# Mario Leaderboard

Mario Leaderboard is a self-hosted network services app. A self-hosted Docker-based Mario leaderboard site that stores the top ten scores in local JSON files. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/3016/mario-leaderboard

## Description

A self-hosted Docker-based Mario leaderboard site that stores the top ten scores in local JSON files.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

33/100 (Low), based on 3 of 4 factors.
- Maintained: 52 (last commit 208 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/articwone/mario-leaderboard
- Unraid: https://ca.unraid.net/apps/mario-leaderboard-189elbo11uehvk?q=Mario-Leaderboard
- GitHub: https://github.com/ArticWone/Mario-Leaderboard

## Common questions

### Which port should I expose for the Mario Leaderboard container?

The examples map host port 18673 to container port 80.

### Where are submitted scores stored so I can persist or back them up?

Scores are stored in a local JSON file at /data/scores.json, so mount a persistent Docker volume at /data.

### How do I use the score API and what submission limits apply?

Use /api/scores with GET to read the top 10 and POST JSON containing name and score to submit. Names are normalized to 6 uppercase letters/numbers, and scores must be whole numbers from 0 to 9999999.

### What health check endpoint is available for Docker?

The server exposes /healthz for Docker health checks.

### Which release channel and Unraid template image are listed?

The README lists beta.1.0.5 as the current release channel and says the Unraid Docker template uses the latest image.

---
Source: Our Local Host (https://ourlocalhost.com/app/3016/mario-leaderboard), the self-hosted and open-source app directory.
