OPEN SOURCE  ·  SELF-HOSTED  ·  DOCKER

FIELD LOG

// IT INCIDENT TRACKING SYSTEM

A lightweight, self-hosted ops tracker built for IT generalists. Log break/fix work, track assets, document maintenance, and keep a searchable record of everything you've touched — years into the future.

▶ Get Started View Features GitHub  ↗

// INSIDE THE BUNKER

Built for the screen you live on.

Dark olive, amber signal lights, monospaced status lines. Desktop for the desk. Mobile command for the rack aisle.

FIELD LOG // COMMAND
Field Log command dashboard showing outages, live incidents, and task alerts

COMMAND

Operational overview — SLA breaches, live events, outages, licenses, and urgent tasks on one screen.

FIELD LOG // ASSETS
Field Log assets list with health scores and status filters

ASSET REGISTRY

Filterable inventory with health grades, warranty status, and quick status toggles.

FIELD LOG // CORE-DC01
Field Log asset detail page for CORE-DC01 with vendor and topology notes

ASSET DETAIL

Assignment, vendor support, topology notes, QR code, and the full incident timeline.

FIELD LOG // MOBILE COMMAND
Field Log mobile command dashboard on a phone-sized screen

MOBILE COMMAND

Phone-first status strip — breaches, live incidents, outages, and tasks. Installable as a PWA with offline read cache.

// DEPLOY IN MINUTES

bash
# Clone and configure
git clone https://github.com/devkhelms/Fieldlog.git
cd Fieldlog
cp .env.example .env
# Edit .env — set credentials and SMTP

# Build and start
docker compose up -d --build
docker exec issuetrack python migrate.py

# Open http://<host>:5000

// CAPABILITIES

Everything you need.
Nothing you don't.

☷

COMMAND DASHBOARD

Live incidents, SLA breach alerts, maintenance due, warranty warnings, active outages, and tasks — all on one screen.

⚙

ASSET REGISTRY

Full hardware inventory with status, assignment, condition, warranty tracking, health scoring, custom fields, and QR print sheets.

⚠

INCIDENT LOGGING

Break/fix, upgrades, maintenance, and notes. Live-event workflow with running notes, close-out, severity, and optional RCA with PDF export.

✉

EMAIL ALERTS

Notify contacts on incident close, weekly digest, aging alerts, maintenance reminders, and automated monthly PDF reports.

☌

GLOBAL SEARCH

Full-text search across assets, incidents, knowledge base articles, and tasks. Press / from anywhere.

📄

KNOWLEDGE BASE

Searchable Markdown articles with tags and file attachments. Link articles to assets or incident types for quick reference.

▶

TASK BOARD

Linked task board with priority, due dates, and status. Create an incident directly from a completed task.

📷

MOBILE QUICK-LOG

Stripped-down mobile interface for fast incident logging in the field. Template picker, searchable asset selector, immediate close option.

⚙

MAINTENANCE & SCHEDULING

Recurring maintenance tasks per asset with staggered start dates, overdue tracking, and dashboard alerts.

📈

REPORTS

Month-end PDF report and time-tracking breakdown by asset and incident type. Auto-email on a configurable schedule.

⚑

AUDIT TRAIL

Every create, update, and close-out logged with field-level before/after diffs. Filterable audit log page.

⚓

INTEGRATIONS

Token-protected REST API, outgoing webhooks (Slack, Teams, ntfy), asset ping monitor, and CSV export.

// STACK

Boring tech. On purpose.

No Node.js build step. No external SaaS. Runs as a single Docker container on any Linux host.

LayerChoiceNotes
AppPython 3.12 + FlaskSingle app.py, no blueprints
DatabaseSQLiteFile on a Docker volume
ServerGunicorngthread worker, 1 process
PDFWeasyPrintRCA reports, month-end report
SchedulerAPSchedulerDigests, pings, reminders
EmailSMTP / STARTTLSWorks with Zoho or any provider
UIJinja2 + hand-written CSSChart.js for dashboard charts

// EASTER EGGS

HIDDEN GAMES

Two small games are built into the desktop UI. Type the activation word anywhere on a page — not inside a search box or form field.

Type SNAKE for classic snake (arrows / WASD, Esc to exit).
Type BOOM for minesweeper (medium board; best time saved locally).

// DEPLOY IT

Runs anywhere Docker runs.

A Raspberry Pi on your desk, a VM on your server, a VPS behind WireGuard. If Docker runs there, Field Log runs there.

▶ Setup Guide View Source  ↗