SAM_VIEWER=true (set only by the records package's viewer/docker-compose.yml) makes the app a read-only copy of an archive, for whoever receives the records: `docker compose up`, then open http://localhost:3000. - At start (bin/docker-entrypoint → sam:viewer:prepare) the package's .sam.zip, mounted read-only, is imported once. - No sign-in: everyone browses as a built-in account. Nothing can be changed: any request but GET/HEAD is refused, no role permission applies (so no edit buttons), and there's no sign-out or profile. A banner names the archive and when it was exported. - It refuses to start, and every page answers 503, when the database has any other account, so turning it on for a real installation stops the app instead of exposing its records. - The viewer listens on 127.0.0.1 only, and skips scheduled jobs (reminders, backups, AD searches). - Docs: the package README (three steps now), Access & sharing, README settings and features, the suggested recordkeeping procedures. Checked end to end with a built image and a real records package: the archive imported at start, pages browsed without an account, a change refused, and the container refusing to start once an account existed. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
29 KiB
Simple Aircraft Manager (Rails)
A Ruby on Rails port of Simple Aircraft Manager, a self-hosted app for tracking records and status for small fleets of aircraft: components and TBO, squawks, ADs, inspections, logbook, documents, oil and fuel trends, and read-only share links for mechanics and buyers.
The port aims to be easy to host. It runs as one process with one SQLite database directory. It needs no Postgres, no Redis, no nginx, and no Kubernetes.
Disclaimer: this software is provided as is, without warranty of any kind, and is not approved or endorsed by the FAA or any other aviation authority. If you use it, it is up to you to verify that it is legal and suitable for your use case. See Disclaimer.
Stack
- Ruby 4.0, Rails 8.1, SQLite. Solid Queue and Solid Cache both use SQLite, so there are no extra services. Background jobs (nightly backup and records check, weekly reminders and AD search) run in the web process.
- Hotwire (Turbo and Stimulus) with importmap, so there is no Node build step. Tailwind CSS 4 runs through
tailwindcss-rails. - Active Storage on local disk handles pictures, document pages, squawk attachments, and track logs; libvips makes the photo thumbnails. Identical files are stored once (hard links).
- Chartkick and Chart.js draw the oil and fuel charts.
- Authentication uses the Rails 8 built-in generator (sessions plus password reset), emailed sign-in links, and optional OpenID Connect single sign-on (OmniAuth).
- Prawn renders the printable logbook entries; Commonmarker renders Markdown notes and the user guide.
Versions
Releases are numbered year.month.release (2026.11.0, 2026.11.1, … restarting each month) in VERSION, and identified exactly by the build: the commit they were built from. Both show on Admin → About; CHANGELOG.md has the release notes (in the app: Help → What's new). Each release is tagged v<version> in git and on Docker Hub.
User guide
The user guide explains how to use the app, for pilots, owners, mechanics and admins. The same pages are shown in the app under Help.
Quick start (development)
bundle install
bin/rails db:prepare
DEMO=1 bin/rails db:seed # optional: demo aircraft N12345
bin/dev # http://localhost:3000
With demo data, sign in as admin@example.com / demo-password-123 (admin, owner of N12345) or pilot@example.com / demo-password-123 (pilot).
Without demo data, the first visit asks you to create the admin account. It needs the one-time setup code printed in the server's log (the line starting Setup code), so only whoever runs the server can claim it.
Run the tests: bin/rails test
Hosting
Everything persistent lives in storage/: the SQLite databases and the uploaded files. Back up that one directory (see Backups).
Option A: Docker Compose (simplest)
cp .env.example .env # set SECRET_KEY_BASE (bin/rails secret), APP_HOST, FORCE_SSL
docker compose up -d --build # http://<host>:3000
Data lives in the sam_storage volume. Set FORCE_SSL=false only if you serve plain HTTP on a private network: passwords and sign-in cookies then travel unencrypted. Set it to true when a TLS reverse proxy such as Caddy, Traefik, or Cloudflare Tunnel sits in front, or use the built-in HTTPS below.
The first visit asks for the setup code from the log: docker compose logs web | grep "Setup code".
Other examples in the repository:
docker-compose.image.yml: runs the published image (barrettefab/simple-aircraft-manager-railson Docker Hub) without cloning the source, with a health check and update steps.docker-compose.direct.yml: directly on the internet with HTTPS and no proxy. The image's web server gets and renews a Let's Encrypt certificate forTLS_DOMAINby itself (ports 80 and 443 must reach the server).docker-compose.traefik.yml: behind Traefik with HTTPS, with optional Authentik forward auth (see Running behind Authentik).
.env.example lists every setting, grouped and commented. After starting or updating, docker compose exec web bin/rails sam:doctor checks the installation.
Option B: Kamal (any VPS, automatic TLS)
Edit config/deploy.yml with your server IP, registry, and domain, then run bin/kamal setup. Kamal Proxy handles Let's Encrypt certificates. Background jobs run inside Puma (SOLID_QUEUE_IN_PUMA).
Option C: Plain server / PaaS
The app is a standard Rails app. Run bin/rails db:prepare && bin/thrust bin/rails server with RAILS_ENV=production, SECRET_KEY_BASE, and SOLID_QUEUE_IN_PUMA=true. Mount storage/ on persistent disk.
Environment variables
| Variable | Purpose |
|---|---|
SECRET_KEY_BASE |
Required in production (bin/rails secret). Anyone who knows it can sign in as anyone, so the app won't start with a placeholder or one under 32 characters, and sam:doctor flags one under 64. Alternatively provide RAILS_MASTER_KEY. |
FORCE_SSL |
true (default) redirects to HTTPS and sets secure cookies. Use false for plain HTTP, only on a private network. |
TLS_DOMAIN |
Optional. HTTPS without a proxy: the app gets a Let's Encrypt certificate for this name (see docker-compose.direct.yml). |
APP_HOST |
Host name the app is reached at, used in email links (password resets, sign-in links, signing invitations, reminders). When set, the app answers only for this name, the APP_URL host, ALLOWED_HOSTS, localhost and IP addresses. |
ALLOWED_HOSTS |
Optional. Other names the app may be reached by, comma-separated (e.g. a LAN name). |
AIRTRAIL_ALLOWED_HOSTS |
Optional. AirTrail servers on your private network that anyone may connect to, comma-separated. Admins can always connect to private addresses; nobody can use the server itself or link-local addresses. |
SMTP_ADDRESS, SMTP_PORT, SMTP_USERNAME, SMTP_PASSWORD, MAIL_FROM |
Optional. They enable email: password resets and Email me a sign-in link. Without them an admin resets passwords from Users. Check the setup with Admin → About → Send test email. |
SMTP_TLS |
true for servers that use TLS from the start. That's the default on port 465; other ports upgrade with STARTTLS. |
VAPID_PUBLIC_KEY, VAPID_PRIVATE_KEY |
Optional. The key pair that signs push notifications (generate with bin/rails runner 'k = WebPush.generate_key; puts k.public_key, k.private_key'). Without them the app generates a pair once and keeps it in storage/vapid_keys.json. Changing it turns notifications off on every device until they're turned on again. |
TZ |
Optional. The installation's time zone, Docker's standard setting, e.g. America/New_York: scheduled jobs (nightly backup, the 7am overdue check, Monday reminders) run on its clock, and it's used for anyone whose device zone isn't known yet. Each person sees times in their own zone (Profile, or their device). Default UTC. |
APP_LOCALE |
Optional. The app's language, e.g. es for config/locales/es.yml (see Translating). Default en. |
ANTHROPIC_API_KEY |
Optional. Lets Claude transcribe scanned logbook pages into entries (Logbook → Import scans). Without it, scans are only uploaded. |
LOGBOOK_AI_MODEL, LOGBOOK_AI_EFFORT |
Optional. The Claude model and effort used for transcription (default claude-opus-5-5, high). |
APP_URL |
Optional public base URL, e.g. https://aircraft.example.com (default https://APP_HOST). Used for the SSO and Google Drive redirect URIs. |
OIDC_ISSUER, OIDC_CLIENT_ID, OIDC_CLIENT_SECRET |
Optional. Turn on single sign-on with an OpenID Connect provider (see below). |
OIDC_PROVIDER_NAME |
Button label, e.g. Authentik (default SSO). |
OIDC_AUTO_CREATE_USERS |
true creates an account for anyone the provider lets in, without an invitation. New accounts start with no aircraft. Default off: accounts come only from an admin, an admin's invitation, or an Owner's signing invitation (signing in with SSO from the link makes the account). |
OIDC_TRUST_EMAIL |
true links existing accounts by email even if the provider doesn't mark it verified. Only use it if users can't edit their own email at the provider. |
OIDC_ADMIN_GROUP |
Optional. Members of this provider group become admins and others lose admin, synced at each sign-in. |
PWNED_PASSWORDS_CHECK |
false turns off the check of new passwords against Have I Been Pwned (only the first 5 characters of the password's SHA-1 are sent). Use it if the server has no outbound internet access; the check also allows the password if the service can't be reached. |
PASSWORD_LOGIN |
false hides email/password sign-in, emailed sign-in links and password resets once SSO works. It's ignored while SSO isn't configured, so you can't lock yourself out. |
APP_REPOSITORY_URL |
Optional. The source code link on Admin → About, for a fork. |
APP_IMAGE |
Optional. The image the records package's viewer runs, used as is (for a fork). Default: the published image at the release that made the package. |
SAM_VIEWER, SAM_VIEWER_ARCHIVE |
Only for the records package's viewer (its viewer/docker-compose.yml sets them). SAM_VIEWER=true makes the app a read-only copy with no sign-in: it imports the .sam.zip at SAM_VIEWER_ARCHIVE at start, everyone browses as a built-in account, and nothing can be changed. It refuses to start on a database with any user account, so turning it on for a real installation stops the app instead of exposing its records. |
APP_REVISION, APP_BUILT_AT |
Set as Docker build arguments (see the Dockerfile) so Admin → About shows the version and the records keep a software version history. |
Single sign-on (Authentik example)
- In Authentik, create an OAuth2/OpenID Provider (confidential client) with the redirect URI
https://YOUR-HOST/auth/oidc/callbackand the scopesopenid,emailandprofile. Then create an Application that uses it. - Set
OIDC_ISSUERto the provider's issuer URL (https://auth.example.com/application/o/<slug>/), plusOIDC_CLIENT_ID,OIDC_CLIENT_SECRETandOIDC_PROVIDER_NAME=Authentik, then restart. - The sign-in page now shows Sign in with Authentik. The first SSO sign-in links an existing account with the same email if Authentik marks the email verified. Otherwise, sign in with your password and use Profile → Link Authentik.
- Once everyone can sign in with SSO, optionally set
PASSWORD_LOGIN=false.
Other OIDC providers (Keycloak, Google, Entra ID…) work the same way.
To keep the whole app behind Authentik's forward auth (proxy provider) while share links and outside mechanics' signing invitations still work, see Running behind Authentik: it has the unauthenticated URL list and what each one exposes.
Account recovery
Locked out of the admin account? On the server, bin/rails users:list, then for example bin/rails "users:reset_password[admin@example.com]" (a new password, shown once) or bin/rails "users:sign_in_link[admin@example.com]" (a one-time link). With Docker: docker compose exec web bin/rails …. All commands (unlock, two-factor reset, enable, make or create an admin) are listed in the administration guide.
Backups
SQLite runs in WAL mode, so a plain file copy taken while the app is running can be inconsistent. Use the SQLite backup command instead:
mkdir -p backup
for db in storage/production*.sqlite3; do sqlite3 "$db" ".backup 'backup/$(basename "$db")'"; done
rsync -aH --exclude '*.sqlite3*' storage/ backup/ # uploaded files (-H keeps the hard links that store duplicates once)
Alternatively, stop the container and copy the volume.
To restore, stop the app and run bin/rails backups:restore (the newest nightly copy, or a file such as one downloaded from Google Drive); it checks the copy first and keeps the current database aside. Then bin/rails records:check verifies the history and signatures. bin/rails sam:doctor gives a health report of the whole installation. All commands are in the administration guide.
The app also makes a verified copy of the main database every night in storage/backups (Admin → About shows the last one), so a backup of the storage volume always contains a consistent database snapshot.
For an off-site copy without extra tools, Admin → Off-site Backup connects a Google Drive account: each night the verified database copy and any new uploaded files are copied there, and a restore test checks them. Setup and restoring are in the administration guide. Keep SECRET_KEY_BASE somewhere safe off the server: stored secrets (API keys, the Drive connection) and electronic signature seals depend on it.
To back up or move a single aircraft with all its files, use More → Download .sam.zip on the aircraft (or bin/rails "sam:export[N12345]"). Import it from Fleet → More → Import from a .sam.zip archive (or bin/rails "sam:import[file.sam.zip,owner@example.com]"). The archive format is the original Simple Aircraft Manager's, so archives move between the two apps.
Features
| Area | Notes |
|---|---|
| Fleet dashboard | Every aircraft you can access, with airworthiness status and its top issues. |
| Airworthiness | Grounded / limited (e.g. "VFR only" for an overdue 91.411 check) / due soon / current, from AD compliance, grounding squawks, inspections, replacement-critical and expiring parts, and expiring documents (an expired registration grounds). Warnings start 10 hours or 30 days ahead. The pilot in command still decides airworthiness (91.7). Logic: app/services/airworthiness.rb, app/services/compliance.rb. |
| Hours | Absolute tach/hobbs updates or per-flight logs. Both apply the delta to every in-service component. Downward corrections are clamped at 0. Each aircraft picks tach or Hobbs as its maintenance clock (time in service). |
| Flight import | Import historical flights from .xlsx or .csv (Date, From, To, Tach, Hobbs, Oil Added, Fuel Added). Each flight's time is derived from the previous row's reading. A preview flags typos such as a tach going backwards, and rows already imported are skipped. History only: component hours aren't changed unless you choose to advance the aircraft's meters. |
| Airworthiness enforcement | Optional per aircraft. It blocks flight logs and hours updates while the aircraft is grounded (not for limitations). |
| Components | Tree of parent and child parts, TBO and replacement limits, and service/replace reset. New component types can be created inline. |
| Squawks | Four priorities. "Ground Aircraft" grounds the aircraft. Inoperative items can be deferred under 91.213(d) after confirming each condition; resolving can record the fix as a logbook entry. Attachments, reopen. |
| Notes | Per-aircraft notes in Markdown, with a preview; shown on share links. |
| ADs and bulletins | Shared across aircraft and applicable to the airframe or to specific components. Hour- and month-based recurrence (due at end of month), conditional and non-mandatory types, per-aircraft "not applicable" determinations, and compliance history with method of compliance and the revision complied with. |
| New ADs | Weekly search of the Federal Register for newly published ADs mentioning the aircraft model, the engine and propeller models and families, or any installed component's maker, type and model (plus your own terms); tracking one found through a component makes it apply to that component. Review each: track it as an AD or dismiss it. |
| AD import | Import ADs from an FAA DRS export (.xlsx recommended: its AD numbers link to each AD's DRS page, which the import keeps; .csv works without links). ADs are matched by number, so nothing is duplicated. The preview suggests Track, Not applicable or Skip for each AD, and flags superseded or non-current ADs, model mismatches, appliance or STC-only ADs, and repetitive actions. |
| Inspections | Shared inspection types with hour, month, and day recurrence, plus history. Each says what overdue means (grounded, no IFR, no transponder, advisory); an annual can also count as the 100-hour, and the 100-hour's 10-hour overrun is credited (91.409(b)). One click adds the standard Part 91 set. |
| Logbook | Maintenance entries with search and a link to a scanned document page. Records the signer's certificate kind and number and an inspection's result, and flags what 43.9 / 43.11 needs that's missing. Entries transcribed by Claude stay "unverified" until someone checks them against the scan. Entry templates (built-in pilot preventive maintenance per 43.3(g) and Part 43 Appendix A(c); admins add and edit their own under Admin → Logbook templates). Engine and propeller entries link the component and record its total time and time since overhaul (SMOH/SFOH/SNEW) at the entry, worked out from the entry's airframe total time; sub-components (an oil filter on the engine…) can be included with their own times. Print entries as a PDF on Avery 5163/8163 or 5164/8164 labels or half-letter/letter pages (boxed) to sign and put in the paper logbook. |
| Documents | Collections, multi-file documents with a page viewer (PDFs drawn page by page with PDF.js on phones, fetching only the pages viewed), per-document share visibility, bulk upload, and expiration dates (registration, insurance…). Their text is read for search: PDF text layers directly, scans by Tesseract OCR (in the image) or optionally Claude. |
| Electronic signatures | Logbook entries can be signed electronically along the lines of AC 120-78B chapter 2: the signer reviews the entry, picks their certificate, re-enters their password (or signs in again with SSO) and confirms a "Certified by" statement. The signature records who, which certificate, the statement, the time and a SHA-256 fingerprint of the entry, sealed by the server; the signer gets an email. Signed entries are locked: a correction is a new signed entry that supersedes the original. Owners can invite an outside mechanic to sign one entry with their own account. Disabled accounts can't sign; their past signatures stay. |
| Records integrity | Every change to maintenance records is kept (who, when, field by field) in a hash chain per aircraft (Activity → Record history). Nightly: a verified SQLite backup in storage/backups (how many are kept: Admin → Settings), then a check of the history chains and every signature; admins are emailed on a problem (Admin → About). Software versions are recorded. A records package (Access & Sharing) bundles every entry as a PDF with signatures, a signature register, the history, the status report and the .sam.zip for the FAA or a buyer, with a README and a ready-to-run viewer/docker-compose.yml: docker compose up gives the recipient a read-only copy of the app on their own computer, with the archive imported and no sign-in (SAM_VIEWER). Scans of paper logbooks can be marked as legacy records, with an "electronic records since" date per aircraft. |
| Off-site backup | Nightly copy of the verified database snapshot (newest 30 kept) and every new uploaded file to Google Drive, using your own Google OAuth client and the drive.file scope (the app sees only its own files). Restore test from the admin page; failures emailed to admins; bin/rails offsite:restore_files brings files back after a restore. |
| Recordkeeping procedures and audits | Admin → Recordkeeping Procedures generates the procedures document AC 120-78B asks for (who is responsible, who may sign, signing, corrections, backups, access, audits, transfer, legacy records) from the system setup plus a few details you fill in (with suggested text built from the installation's settings; a revision can't be adopted while a [bracketed] blank is left); adopt it as numbered, unchangeable revisions, included in the records package. Admin → Records Audits is a periodic QC checklist (app checks plus a restore test, a sample of entries against source documents and a user review); admins get the due date in the weekly reminder. The users' instructions are the guide's Electronic records and signing page. |
| Major repairs and alterations | Form 337, STC, and ICA tracking; an STC's ICA can become a tracked recurring inspection. |
| Weight & balance | History of empty weight and CG (linked to the alteration that changed them) and a loading calculator: takeoff and landing weight and CG against max gross and the CG envelope. The envelope can be entered as CG (inches) or as moment (lb-in/1000, as in POH moment charts and Garmin Pilot). |
| Status report | A printable maintenance status (91.417(a)(2)): total times, life-limited parts, time since overhaul, inspections, ADs with method and revision, major alterations, open discrepancies. Also on maintenance share links. |
| Calendar feed | A private iCalendar link (Profile) with everything coming due on your aircraft as all-day events; hour-based items get a date projected from the past year's flying. |
| Reminders | A Monday email to those whose role gets reminders (Owners and Mechanics by default) when something is overdue or coming due, plus push alerts when something becomes overdue, and to anyone whose certificate (e.g. an IA) is about to expire; admins also get the records audit due date (needs SMTP; users can turn it off). |
| Oil and fuel | Records, trend charts, and averages (last 20 intervals, IQR outlier filtering, manual exclusion). |
| Activity log | Every write is recorded as an AircraftEvent; the Activity tab loads them as you scroll. |
| Access | Configurable roles per aircraft (see Roles), admins' invitation links (limited uses, expiry, optionally one email address) that give an account and roles, plus share links (Current Status or Maintenance Detail, optional expiry, at most 10 per aircraft). Admins can disable accounts; a disabled account can't sign in or sign entries, and its past signatures stay. |
| Sign-in security | Passwords of at least 12 characters, checked against known breaches (Have I Been Pwned, k-anonymity). 10 failed sign-ins in a row lock an account for 15 minutes from any address, and the user is emailed; admins can unlock. Optional authenticator-app (TOTP) codes with recovery codes for password and emailed-link sign-in and for signing entries; admins can reset them. Rate limits per address on every sign-in form. |
| Phones and offline | Installable (PWA). Flights and squawks logged without signal, or with one too weak to answer within 10 seconds, are kept on the device and sent later, never twice. The Fleet, Overview, W&B, Log Flight and Report Squawk pages are saved ahead of time; any other page falls back to an offline page. The top bar turns red when the server can't be reached, and a ring shows saving and sending progress. |
| REST API | Personal and integration tokens with scopes, read endpoints, squawks, draft logbook entries for signing in the app, and signed webhooks (docs). Follows the person's role. |
| Help | The user guide, shown in the app under Help. |
Roles
Each person has a role on each aircraft, and a role is a set of permissions (app/models/permission.rb) that administrators change under Admin → Roles, where they can also add their own. The built-in roles as they come:
| Action | Viewer | Pilot | Mechanic | Owner |
|---|---|---|---|---|
| View everything on the aircraft | ✓ | ✓ | ✓ | ✓ |
| Log flights, correct own flights | ✓ | ✓ | ||
| Update hours, report and defer squawks (91.213(d)), add notes/oil/fuel | ✓ | ✓ | ✓ | |
| Sign logbook entries with their own certificate | ✓ | ✓ | ✓ | |
| Logbook, components, ADs, inspections, documents, major records, W&B; edit squawks, notes, oil/fuel | ✓ | ✓ | ||
| Reminders and overdue alerts | ✓ | ✓ | ||
| Correct or delete any flight, imports, exports, restore from history | ✓ | |||
| Edit or delete the aircraft, manage people and share links | ✓ |
Owner always has every permission. Only an Owner can give the Owner role, nobody changes their own, and every aircraft keeps an Owner. Administrators can do everything on every aircraft and manage users, roles, component types, airports, templates, settings, off-site backup, procedures and audits. Whoever adds an aircraft becomes its Owner (who can add aircraft is an admin setting: administrators only by default). Controllers declare the permission each action needs (requires_permission); a write with none declared is refused.
Users who aren't on an aircraft get a 404 for it, identical to a missing record.
Mapping from the Django original
| Django | Rails |
|---|---|
health/services.py |
app/services/airworthiness.rb, compliance.rb, hours_service.rb, consumption_stats.rb |
AircraftScopedMixin / core/permissions.py |
app/controllers/concerns/aircraft_scoped.rb |
EventLoggingMixin / log_event |
Aircraft#log_event!, called from controllers |
| DRF viewsets + Alpine.js mixins | Server-rendered controllers and ERB views with Turbo |
AD |
AirworthinessDirective |
MajorRepairAlteration |
MajorRecord |
DocumentImage |
Document has_many_attached :pages |
AircraftShareToken |
ShareToken (has_secure_token) |
views_public.py |
SharedController → /shared/:token |
Differences from the original:
- Integer primary keys instead of UUIDs. Share tokens are 32-character random strings.
- Logbook entries and inspection records don't keep many-to-many links to components. An inspection record or AD compliance can reference one component.
- Accounts are created only by an admin, by the first-run setup, by someone opening an admin's invitation link (with a password, or SSO), by an outside mechanic from an Owner's signing invitation (for its address), or at first SSO sign-in when
OIDC_AUTO_CREATE_USERSis on. Who can add aircraft, and so become an Owner, is an admin setting (administrators only by default).
Not yet ported
The MCP server for AI agents, Prometheus metrics, per-aircraft feature switches (only airworthiness enforcement is here, as an aircraft setting), the plugin system, and the desktop builds.
Added in this port
AirTrail sync and export, an airport database, FAA DRS AD import, spreadsheet flight import, engine monitor data (CGR-30P/C) with interactive charts, multiple squawk attachments with a photo viewer, AI logbook transcription with Claude (images and PDFs), printable logbook entries, electronic signatures and recordkeeping along the lines of AC 120-78B (record history, nightly integrity checks, records package, procedures and audits), off-site backup to Google Drive, a user guide, and an installable app (PWA) that logs flights and squawks offline, keeps pre-flight pages for use without signal, and sends push notifications.
Translating
Every piece of text the app shows (pages, emails, messages, labels, printed logbook entries, the procedures and records-package text, and the scripts' messages) is in config/locales/en.yml. To translate the app:
- Copy
en.ymlto<locale>.yml(for examplees.yml), change the top key fromen:toes:, and translate the values. Keep the%{name}placeholders and any HTML tags in keys ending in_html. Keys withone:/other:are counted forms. - For month and day names in dates, also add that language's standard Rails translations (for example from the rails-i18n project).
- Set
APP_LOCALE=esand restart. Anything not yet translated shows in English.
Where the text lives in en.yml: labels: are the names of stored values (statuses, types, priorities); activerecord: holds field names and validation messages; flash: holds the messages shown after an action; services:, models: and helpers: hold text built in Ruby; js: holds the scripts' text; the rest are keyed by page (<controller>.<view>.<key>). The user guide under Help is Markdown in docs/guide and is translated separately.
In development and tests a missing translation raises an error, so a page that uses a key not in en.yml fails its test.
Disclaimer
Simple Aircraft Manager is provided as is, without warranty of any kind, express or implied. It is not approved, certified or endorsed by the FAA or any other aviation authority.
If you use it, it is up to you to verify that it is legal and suitable for your use case: that its electronic records, signatures, backups and procedures meet the regulations that apply to your aircraft and operation (for example 14 CFR 43.9, 43.11 and 91.417, and AC 120-78B), and that anything you print, export or share from it is acceptable to whoever receives it. Check with your aviation authority, mechanic or inspector, insurer and, where needed, a lawyer.
The airworthiness status, due dates, AD matches and projections come only from the records entered and may be incomplete or wrong. They don't replace the aircraft's actual records or the pilot in command's airworthiness decision (14 CFR 91.7). To the extent the law allows, the authors and contributors are not liable for any damage, loss, fine or injury arising from use of the software. Whoever hosts an instance is responsible for running, securing and backing it up.
The same text is in the app under Help → Disclaimer.
License
The original project is released under The Unlicense. This port follows the same spirit.