Documentation

What each part of Scilago does, with screenshots, plus the technical guides.

🚀
Quick Start
Installation & setup
📡
API Reference
All endpoints
🐳
Deployment
Docker Compose
🧪
Testing
Running the test suites

Feature Guide

Core

Dashboard

Your aquarium command center. See all tanks at a glance and what needs doing today.

  • ✓ Multi-tank overview with parameter sparklines and maturity badges
  • ✓ “Today” list: overdue doses, maintenance and water tests, for one tank or all
  • ✓ Low-stock alerts for consumables
  • ✓ Tips filtered by water type
DashboardDashboard
Tank ManagementTank Management
Core

Tank Management

Manage multiple tanks with detailed profiles. Saltwater, freshwater, or brackish — 17 subtypes supported.

  • ✓ Display + sump volume tracking
  • ✓ Tank images, archiving, refugium support
  • ✓ Report card graded A+ to F over 6 categories, with score history, achievements and a PDF to download (server)
  • ✓ Visual timeline with events and milestones
  • ✓ Emergency checklists (power outage, leak, overheating, dead animal) with a running timer; the incident goes into the tank’s journal
Core

Water Parameters

Track temperature, salinity, pH, alkalinity, calcium, magnesium, nutrients and more. Normal ranges adapt automatically to your tank type across 17 subtypes.

  • ✓ 11 standard parameters + 7 optional tests per tank (iodine, strontium, potassium, boron, iron, silicate, copper)
  • ✓ Tank-type-aware ranges: SPS, LPS, FOWLR, Planted, Discus, Shrimp, and 11 more
  • ✓ CSV export
  • ✓ Charts with normal range, ideal line and time ranges from 7 days to all
  • ✓ Test-kit formats converted for you (Hanna, Salifert, Red Sea…)
  • ✓ Health timeline: losses, diseases and notes marked on the charts, with the parameters that moved in the two weeks before
ParametersParameters
LivestockLivestock
Living

Livestock & Compatibility

Track every fish, coral, and invertebrate. Compatibility checking with an 8-rule engine over 90+ species.

  • ✓ Auto-photos from iNaturalist/WoRMS
  • ✓ Compatibility heatmap matrix + network graph
  • ✓ Per-creature timeline (added, moved, died)
CompatibilityCompatibility
Core

Maintenance

Never miss a water change or filter cleaning. Recurring reminders with overdue, due-soon and upcoming counts.

  • ✓ Recurring schedules with custom frequencies
  • ✓ Overdue tasks on the dashboard; on a server, email digests and web push notifications (with quiet hours) once the admin sets up email; in the phone app, reminders arrive as notifications
  • ✓ Completion log with history
  • ✓ Calendar (iCal) and CSV export
MaintenanceMaintenance
EquipmentEquipment
Upkeep

Equipment

Inventory every piece of equipment — pumps, lights, heaters, skimmers, controllers. Track condition, warranties and power consumption.

  • ✓ Warranty tracking with expiry badges
  • ✓ Power consumption per tank (kWh + cost)
  • ✓ Move to/from Consumables
Daily Care

Consumables

Track salt mix, additives, food, filter media, and test kits, grouped by type.

  • ✓ Status follows the stock: Active → Low stock → Depleted, and back to Active when restocked
  • ✓ Feeding, dosing and water changes deduct what they use
  • ✓ Low-stock alerts on the dashboard
ConsumablesConsumables
FeedingFeeding
Daily Care

Feeding

Schedules and a feeding log. Link a food to your consumables for automatic stock tracking.

  • ✓ Recurring schedules with quantity, unit and frequency
  • ✓ “Feed Now” with one tap; overdue schedules flagged
Daily Care

Dosing

Manage calcium, alkalinity, magnesium, and supplement dosing. Calculator, reservoir tracking, and timeline.

  • ✓ Calculator with compound presets (soda ash, calcium chloride, magnesium chloride…) and split-dose advice for large corrections
  • ✓ “Dose Now”, overdue schedules, manual and automatic (doser) schedules
  • ✓ Reservoir tracking: each dose is deducted from the linked consumable
  • ✓ Dose history and timeline
DosingDosing
DiseasesDiseases
Daily Care

Health & Diseases

Document outbreaks and tank problems, track treatments, and monitor recovery. A built-in list of 40+ common diseases and tank problems, with their symptoms.

  • ✓ Health issues for one animal or the whole tank, with severity and status (active, monitoring, chronic, resolved)
  • ✓ Treatment log with medication tracking
  • ✓ Related photos for visual documentation
BreedingBreeding
Daily Care

Breeding

Track breeding projects from courtship to fry. Spawning logs, egg care, and fry count tracking.

  • ✓ Project lifecycle (planning → spawning → raising fry)
  • ✓ Event logs with fry count tracking
Daily Care

Water Changes

Five tabs: log & history, correction plan, target parameter, impact preview, and water and salt consumption.

  • ✓ Dilution calculator with live preview
  • ✓ 5 salt mix presets, plus RO/DI and tap water
  • ✓ Water change timeline
Water ChangesWater Changes
LightingLighting
Daily Care

Lighting

Multi-channel LED schedule management with 6 built-in presets and area charts.

  • ✓ Multi-channel intensity curves
  • ✓ 6 built-in presets (Acropora/SPS, LPS & mixed reef, soft corals, planted, refugium)
Analysis

Finances

Track spending by category and tank. Budgets, monthly charts, and electricity costs.

  • ✓ Category breakdown, electricity included
  • ✓ Monthly spending charts
  • ✓ Budgets with a progress bar and over-budget warning
FinancesFinances
Analysis

ICP Tests

Keep your ICP-OES lab results per tank: 50+ elements across 5 groups, with quality scores and a status for each element.

  • ✓ 50+ elements: major, minor, nutrients, pollutants
  • ✓ Quality scores (0–100) per element group
  • ✓ Phone app: import the CSV export of an ATI report (“Open in Scilago” works too)
  • ✓ Server: upload the PDF report from ATI and every element is read and scored; matching elements (Ca, Mg, KH, NO₃, PO₄…) also appear on the parameter charts
  • ✓ Test history per tank, element tables with color-coded status

Elements Tracked

Base: Salinity, KH
Major (10): Cl, Na, Mg, S, Ca, K, Br, Sr, B, F
Minor (18): Li, Si, I, Ba, Mo, Ni, Mn, As, Be, Cr, Co, Fe, Cu, Se, Ag, V, Zn, Sn
Nutrients: NO₃, P, PO₄
Pollutants (10): Al, Sb, Bi, Pb, Cd, La, Tl, Ti, W, Hg
Sharing

Sharing & Vacation Mode

Share a tank with a public link, give access to people you trust, or leave a page for whoever looks after it while you’re away. All from the tank’s Sharing tab.

  • ✓ Public read-only tank profile: volume, livestock, photos, lighting, maturity and report card
  • ✓ Invite people by email, with read or write access
  • ✓ Access links that can expire and be revoked at any time
  • ✓ Vacation mode: a sitter page with no account needed, built from the tank’s schedules, reminders and stock, plus your instructions and emergency steps; the link stops working the day after you’re back
Sharing tab with vacation modeSharing tab with vacation mode
Tools

Test Lab & Tools

Small tools for the moments between two tests.

Test Lab

  • Step-by-step procedures for 21 test kits (API, Hanna, Salifert, Red Sea)
  • Countdown timers that start on the wait steps
  • A floating timer that stays visible on every page, with a sound when it ends

Calculators

  • Water change planner and impact preview
  • Dosing calculator for Ca, KH, Mg and trace elements
  • Unit converter: temperature, volume, salinity, alkalinity, weight, concentration

Learn & more

  • Learn: beginner guides and a glossary
  • Notes, events and photos & videos per tank, sorted into albums
  • Wish list for the livestock and gear you plan to buy
Mobile

Phone App & Offline

Scilago runs in the browser, installs as a web app, and exists as a native app for iOS and Android that keeps everything on the phone.

Native app (iOS / Android)

  • Device-only: data stays in a database on the phone, no server or account
  • Back up to a file through the share sheet; restore a backup, or the export of a Scilago server account, with “Open in Scilago”
  • Reminders for maintenance, dosing and feeding as phone notifications, never during the night
  • Native iOS look, bottom tab bar, swipe back on iOS

Web app & PWA

  • Installable from the browser (“Add to Home Screen”, needs HTTPS)
  • Offline: recently viewed data stays readable, and new entries sync when the connection returns
  • Light and dark themes

Everywhere

  • 15 languages
  • Metric or imperial units, °C or °F, your currency
  • Built from source with Capacitor (see the README)
Data

Your Data

Your aquarium history belongs to you: export it, back it up, restore it.

Export

  • CSV export of parameters, livestock and maintenance
  • “Download my data”: everything about your account in one zip
  • Calendar file (iCal) of maintenance, dosing and feeding schedules

Safety nets

  • Recently deleted: anything deleted in the last 30 days can be restored (Ctrl+Z restores the latest)
  • Server backups by the admin: database and uploads, restore with a preview
  • Phone app: a reminder to back up, and backups through the share sheet

Integrations

  • Personal API tokens for scripts and the reef-pi bridge
  • REST API under /api/v1, documented in the API guide
  • Your server, your database: PostgreSQL you can query
Admin

Admin Panel

For whoever runs the server: users, settings, backups and system health.

Users & settings

  • User management: edit, reset password, delete
  • Module toggles for the whole instance
  • Default country, units and currency
  • SMTP and SMS settings with a test send

Data & storage

  • Backups: create, download, restore with a preview of what they contain
  • Full database dump and restore
  • Storage browser and per-user data export/import

Health & usage

  • System health checks and recent errors
  • Usage statistics
  • Species traits editor for the compatibility checker
Architecture

Tech Stack

FastAPI
Python 3.11 backend
React 18
TypeScript + Vite
PostgreSQL
40+ models
Alembic
Schema migrations
Docker
4-service compose
Tailwind
Dark/light themes
15 Languages
i18next + 35 namespaces
Capacitor
iOS & Android app, SQLite