OSS TanbouOn this page
Overview
BugPin embeds a lightweight widget in web applications so users can capture and annotate screenshots and send them to a self-hosted server together with network, console, browser, and device context. It also supports offline report buffering and GitHub Issues forwarding.
Features and best fit
Based on official documentation; not hands-on tested · Content checked:
Key features
Annotate screenshots with arrows, shapes, text, and privacy blur
Visual markup makes it easier to identify the affected UI area and expected behavior than a text-only issue report.
Sources: [2]
Automatically capture failed requests, console errors, and device metadata
Reports can include 4xx/5xx network requests, console errors, and OS/browser/device context for faster initial diagnosis.
Sources: [2]
Queue reports offline and forward them to GitHub Issues
Reports can be cached locally while offline and synchronized after connectivity returns, and projects can forward reports into GitHub Issues.
Sources: [2]
Best fit
Fits QA and internal-user reporting of UI bugs with reproduction context
It is useful when frontend defects should arrive with both a visual explanation and technical browser context instead of requiring reporters to assemble evidence manually.
Sources: [2]
Before adoption
Change the default administrator password immediately
The official quick start documents admin@example.com / changeme123 as the initial credentials. Change them before exposure and configure domain allowlists, rate limits, and other security controls.
Sources: [2]
v1.2.4 fixes durable image URLs for GitHub-synchronized issues
The v1.2.4 release restores inline screenshots and image attachments using durable repository URLs for newly created and synchronized GitHub issues.
Sources: [3]
Official sources
- [1]aranticlabs/bugpin repository(2026-10-01)
- [2]BugPin README(2026-10-01)
- [3]BugPin v1.2.4 release(2026-10-01)
- [4]BugPin Admin Console AGPL-3.0 license(2026-10-01)
- [5]BugPin Widget MIT license(2026-10-01)
Supplemental curator note
BugPin lets users report issues from the page while attaching annotated screenshots, failed 4xx/5xx requests, console errors, and browser/device context. The embedded widget is MIT-licensed while the Admin Console is AGPL-3.0, so licensing depends on the component being modified or distributed.
Try it in 3 steps
- 1
Start the BugPin container
Follow the documented Docker Run path and start BugPin with a persistent data volume.
docker run -d --name bugpin --restart unless-stopped -p 7300:7300 -v bugpin-data:/data registry.arantic.cloud/bugpin/bugpin:latest - 2
Change the default password
Immediately change the default administrator password from the Profile screen. Configure domain allowlists and rate limits before public exposure.
Open http://localhost:7300 and sign in as admin@example.com / changeme123 - 3
Create a project and connect the widget
Use the generated project API key in the target web application and submit a screenshot-based report to verify the integration.
Create a project, copy its API key, then embed http://localhost:7300/widget.js
Growth
Growth trends · Last 30 days
42 Stars
Trend data is still being collected.
Development activity
Last 90 days · weekly
- Commits (last 30 days)
- 26
- Open PRs
- 0
Development activity is still being collected.
Built with
Categories and tags
GitHub data
GitHub dataView detailed GitHub data
GitHub Topics
- bug
- bug-reporter
- bugreport
- bug-tracker
- bugs
- issue-tracker
- issues
- Stars
- 42
- Forks
- 13
- Watchers
- 0
- Open issues
- 5
- Contributors
- 5
- Owner type
- Organization
- Primary language
- TypeScript
- License
- AGPL-3.0
- Repository last updated
- Sep 30, 2026
Related information
Write a related articleShare a guide or use case for this OSS in Markdown. Articles are published after administrator approval.
Explore next
- Worklenz3,194 Stars
4 shared tag(s) · 2 shared category(s) · Same language
combine project management, time tracking, and resource planning in one self-hosted workspace
TypeScript - Shelf3,022 Stars
4 shared tag(s) · 2 shared category(s) · Same language
manage equipment bookings, custody, and locations around QR-based asset workflows
TypeScript - Cal.diy48,786 Stars
4 shared tag(s) · 1 shared category(s) · Same language
Self-host scheduling pages and calendar integrations from a MIT-only community edition
TypeScript - Kaneo9,313 Stars
4 shared tag(s) · 1 shared category(s) · Same language
manage issues, tasks, and Kanban in a lightweight self-hosted workspace with optional MCP automation
TypeScript - BigCapital3,919 Stars
4 shared tag(s) · 1 shared category(s) · Same language
self-host double-entry accounting, invoicing, inventory, reporting, and bank integrations
TypeScript - LearnHouse2,314 Stars
4 shared tag(s) · 1 shared category(s)
combine courses, assignments, AI, code execution, and collaboration in one self-hosted learning platform
Python
Report incorrect information
Tell us if any listing information is incorrect or outdated.