Repository navigation
Trusted Proxies Developer Guide
(5.8.0, #410, contributed by @cloudcogsio)
Behind a reverse proxy - nginx, a load balancer, a Cloudflare Tunnel - every request reaches FreeITSM from the proxy, so the sign-in log, the audit trails and API key address checks all record the proxy's address. The Docker image's TRUSTED_PROXIES setting makes Apache take the real address from the proxy's header, but only on connections from the proxy. How to set it is in Installation - Behind a reverse proxy; the merge review and the tests on a real nginx stack are in Behind a reverse proxy - review. This page is how it works.
Not to be confused with TRUST_PROXY_HTTPS (Running behind a reverse proxy), which is about the scheme (https://), not the address.
| File | What it holds |
|---|---|
docker-compose.yml |
The two optional settings, commented out: TRUSTED_PROXIES, TRUSTED_PROXY_HEADER
|
docker/entrypoint.sh |
On every start: writes conf-available/freeitsm-remoteip.conf, enables mod_remoteip, checks with apache2ctl -t, warns on wide ranges and host names; never stops Apache |
includes/docker_proxy.php |
dockerProxyState() (what Apache really loaded), dockerProxyListFacts() (wide ranges, names), dockerProxyCheck() (the Test verdict) |
api/system/docker_proxy_check.php |
The Test button: administrators only, Docker only, read-only |
system/docker/index.php |
System → Docker → Behind a reverse proxy: status, the "what a wrong setting does" warning, Test |
includes/api_security.php |
apiIpAllowed() - the range matching the Test shares with API key allow-lists |
docker/proxy-test/* |
A throwaway nginx stack and check-ip.sh that signs in and reads back what system_logs recorded |
tests/docker-proxy-check.php |
20 checks of the verdicts and range warnings, no Docker needed |
FreeITSM reads the client address from REMOTE_ADDR everywhere, and must: a header such as X-Forwarded-For is written by the caller and proves nothing.
// includes/api_security.php
* 🔴 The address is REMOTE_ADDR, the connection's own - never a header such as
* X-Forwarded-For, which the caller writes. Behind a reverse proxy every request
* comes from the proxy, so an allow-list there must name the proxy - the help says so.
* Unless the Docker image's TRUSTED_PROXIES is set: Apache (mod_remoteip) then puts
* the client's address in REMOTE_ADDR itself, before PHP runs, and the allow-list
* names the clients (docker/entrypoint.sh).So the whole feature is Apache configuration. mod_remoteip believes the header only on a connection from a listed proxy, reads X-Forwarded-For from the right, skips every listed address, and puts the first one left into REMOTE_ADDR.
Decided on every start, starting from off - so a host name that no longer resolves, or a value removed from docker-compose.yml, never leaves an old configuration behind:
# docker/entrypoint.sh
REMOTEIP_CONF=/etc/apache2/conf-available/freeitsm-remoteip.conf
remoteip_off() {
a2disconf -q freeitsm-remoteip >/dev/null 2>&1
a2dismod -q remoteip >/dev/null 2>&1
rm -f "$REMOTEIP_CONF"
}
remoteip_off
PROXY_LIST=$(printf '%s' "$TRUSTED_PROXIES" | tr ',\t\r\n' ' ' | tr -s ' ' | sed 's/^ //; s/ $//')
PROXY_HEADER="${TRUSTED_PROXY_HEADER:-X-Forwarded-For}"
if [ -z "$PROXY_LIST" ]; then
:
elif printf '%s' "$PROXY_LIST" | grep -q '[^A-Za-z0-9.:/ -]' \
|| printf '%s' "$PROXY_HEADER" | grep -q '[^A-Za-z0-9-]'; then
echo "TRUSTED_PROXIES or TRUSTED_PROXY_HEADER is not valid, so client addresses are not taken from the proxy." >&2
else
{
echo "# Written by entrypoint.sh from TRUSTED_PROXIES - do not edit."
echo "RemoteIPHeader $PROXY_HEADER"
echo "RemoteIPInternalProxy $PROXY_LIST"
echo 'LogFormat "%a %l %u %t \"%r\" %>s %O \"%{Referer}i\" \"%{User-Agent}i\"" combined'
echo '<Location /server-status>'
echo ' Require all denied'
echo '</Location>'
} > "$REMOTEIP_CONF"
a2enmod -q remoteip >/dev/null 2>&1
a2enconf -q freeitsm-remoteip >/dev/null 2>&1
if APACHE_ERR=$(apache2ctl -t 2>&1); then
echo "TRUSTED_PROXIES is set: ..."
# ...warn on an IPv4 range wider than /24, an IPv6 range wider than /64, and on host names
else
remoteip_off
echo "TRUSTED_PROXIES was refused by Apache, so client addresses are not taken from the proxy: ..." >&2
fi
fi-
Values are whitelisted before they reach a config file (letters, digits,
.:/ -for the list; letters, digits and-for the header name), so nothing can inject an Apache directive. -
apache2ctl -tis the judge. A value Apache refuses turns the feature off and says why indocker logs; Apache always starts. -
%ain the access log is the address aftermod_remoteip; the stock%hwould keep logging the proxy. -
/server-statusis closed while it is on. mod_status allows it withRequire local; with127.0.0.1forgeable through a wide range, "local" would no longer mean local. - Host names (a container name) are looked up once, when Apache starts - restart the container if the proxy's address changes. The log says so.
- It runs before the HTTPS check that follows it, and both start from off, so each tests this start's settings.
dockerProxyState() reads the enabled config file, not the environment variable, so the screen can never say "on" when the value was refused:
// includes/docker_proxy.php
const DOCKER_PROXY_CONF_ENABLED = '/etc/apache2/conf-enabled/freeitsm-remoteip.conf';
function dockerProxyState(): array
{
$env = trim((string)getenv('TRUSTED_PROXIES'));
$header = trim((string)getenv('TRUSTED_PROXY_HEADER')) ?: 'X-Forwarded-For';
$list = [];
$state = 'off';
$conf = @file_get_contents(DOCKER_PROXY_CONF_ENABLED);
if (is_string($conf) && preg_match('/^RemoteIPInternalProxy\s+(.+)$/m', $conf, $m)) {
$state = 'on';
$list = preg_split('/\s+/', trim($m[1]), -1, PREG_SPLIT_NO_EMPTY);
if (preg_match('/^RemoteIPHeader\s+(\S+)/m', $conf, $h)) $header = $h[1];
} elseif ($env !== '') {
$state = 'refused';
$list = preg_split('/[\s,]+/', $env, -1, PREG_SPLIT_NO_EMPTY);
}
return ['state' => $state, 'header' => $header] + dockerProxyListFacts($list);
}dockerProxyListFacts() applies the entrypoint's own thresholds (wider than /24 or /64 is wide) and resolves host names, so the page warns about exactly what the log warned about. The section always shows, in red, what a wrong setting does: too wide (anyone in the range can fake any address - in the sign-in log, the audit trails and past an API key's address restriction), not set (everyone is the proxy), the wrong address (ignored).
api/system/docker_proxy_check.php (System admins via admin_api_guard.php; 400 outside the Docker image) returns dockerProxyCheck(dockerProxyState(), $_SERVER):
if ($state['state'] === 'refused') {
$verdict = 'refused';
} elseif ($state['state'] === 'off') {
$verdict = $headers ? 'off_proxy' : 'direct';
if ($headers) $suggest = $recorded;
} else {
// Found on the real proxy stack: with a range like 172.16.0.0/12 the person's own address
// is inside it too, so "still the proxy" would blame the header when the range is the fault.
$inWide = $recorded !== '' && $state['wide'] && apiIpAllowed(implode("\n", $state['wide']), $recorded);
$isProxy = $recorded !== '' && $state['resolved'] && apiIpAllowed(implode("\n", $state['resolved']), $recorded);
$verdict = $inWide ? 'too_wide' : ($isProxy ? 'still_proxy' : 'working');
}| Verdict | When |
|---|---|
direct |
Off, and no forwarding header arrived: nothing to set |
off_proxy |
Off, and a forwarding header arrived: everyone is recorded as the proxy; suggest is the recorded address - the line to add |
working |
On, and the recorded address is not a listed proxy - the person confirms it is their own computer's |
too_wide |
On, and the recorded address is inside a range wider than one proxy: FreeITSM cannot tell this person from a proxy |
still_proxy |
On, but the recorded address is a listed proxy: the proxy sends no usable header |
refused |
Set, but not in force (see docker logs) |
Behind mod_remoteip the proxy's own address is gone from PHP's view, so the verdict says what it can prove and asks the person to confirm the rest. It reuses apiIpAllowed(), the API allow-list's range matching, so "inside a range" means the same thing in both places. The forwarding headers it echoes back are trimmed to 300 characters.
TRAP: check
too_widebeforestill_proxy. The first version did not, and on the test stack withTRUSTED_PROXIES=172.16.0.0/12it told the tester the proxy was not sending the header - when their own address (the Docker gateway) was inside the range and the range was the fault. A unit test alone would not have found it: it needed a real address inside a real range.
-
Never read the client address from a header in PHP. Use
REMOTE_ADDR; on Docker,TRUSTED_PROXIESis what makes it right behind a proxy. Outside Docker, the same is done in the web server (mod_remoteipon Apache,real_ipon nginx, the equivalent on IIS). -
List the proxy's own address, nothing wider. Every host in a listed range can claim any client address,
127.0.0.1included. - API key allow-lists name the real clients once this is on, not the proxy.
- Make sure nobody can reach the container round the proxy - a direct connection is not from a listed address, so its header is ignored, but its own address is recorded as-is.
php tests/docker-proxy-check.php # the verdicts and range warnings, no Docker
docker/proxy-test/check-ip.sh # the real stack: nginx in front, sign in, read back system_logs
The real-stack cases - normal, forged X-Forwarded-For, forged 127.0.0.1, a header sent straight to the app, /server-status, and the setting empty - are tabled in the review.
Related: Installation · Running behind a reverse proxy · Docker volumes - review
FreeITSM — an open-source IT Service Management platform · github.com/edmozley/freeitsm · MIT licence
- Installation
- ⏰ Scheduled tasks (cron jobs)
-
Architecture
- ↳ 🧹 Root folder tidy (URL routing)
- ↳ 🔗 Database Integrity (FKs & constraints)
- ↳ 🛠️ Database Verification — Developer Guide
- ↳ 🧩 Service Layer (UI + API share code)
- ↳ 🪤 Code traps (the TRAP: comments)
- ↳ 📝 Commenting for the Engineering wiki
- ↳ 🛠️ Engineering wiki scanner - Developer Guide
- ↳ 📊 Service-Layer progress
- 🤝 Contributing (read before a pull request)
- 🧪 Developer tests
- 📄 PDF exports moved to PDFKit (#254)
- AI Providers
- Internationalisation (i18n)
- Timezones & Time Handling
- 📅 Date & Time Formats
- 💱 Currencies
- 🧭 The sidebar (optional module rail)
- 🧩 Preference templates
- 🔀 Display order (modules, Watchtower cards) — Developer Guide
- Theming & Dark Mode
- 🗂️ Recent — getting back to what you were doing
- ⌨️ Command palette (⌘K)
- 🔍 Searching inside tickets
- 📄 Attached documents
-
Mobile‑Friendly
- ↳ 🎫 Mobile: Tickets
- ↳ 💻 Mobile: Assets
- ↳ 📅 Mobile: Calendar
- ↳ 📚 Mobile: Knowledge
- ↳ 🚦 Mobile: Service Status
- ↳ 🗼 Mobile: Watchtower
- ↳ 🧩 Mobile: Problem Management
- ↳ 🔁 Mobile: Change Management
- ↳ 💿 Mobile: Software
- ↳ ✅ Mobile: Tasks
- ↳ 📝 Mobile: Forms
- ↳ 📄 Mobile: Contracts
- ↳ 📄 Mobile: Domains
- ↳ 📄 Mobile: People
- ↳ 🚀 Mobile: Projects
- ↳ 🗂️ Mobile: Files
- ↳ 🎓 Mobile: LMS
- ↳ 🗺️ Mobile: CMDB
- ↳ 🗺️ Mobile: Network Mapper
- ↳ 🧭 Mobile: Process Mapper
- ↳ ⚙️ Mobile: Workflow
- ↳ 🖥️ Mobile: System
- ↳ 📊 Mobile: Reporting
- ↳ 📖 Mobile: System Wiki
- ↳ 🙋 Mobile: Self-Service Portal
- ↳ 🧰 Mobile: Techniques & Tricks
-
Security
- Layer 1 — which modules you can enter
- ↳ 🧩 Module Access Control
- ↳ 🛠️ Module Access — Developer Guide
- ↳ 🔌 Switching modules off
- ↳ 🛠️ Module availability — Developer Guide
- ↳ 📐 Module availability — design (#217)
- Layer 2 — what you can administer
- ↳ 🎭 Roles & Permissions
- ↳ 🛠️ Roles — Developer Guide
- ↳ 🔤 Why capabilities are constants
- Layer 3 — the System module
- ↳ 🔑 Admin Access Control
- Hardening
- ↳ 📄 Security review response 2026-08
- ↳ 🛡️ Security hardening 2026-08
- ↳ 🛠️ Security hardening 2026-08 — Developer Guide
- ↳ 🛡️ Round three — plain English
- ↳ 🛠️ Round three — Developer Guide
- ↳ 🛡️ CSRF protection (S4) — Developer Guide
- Single Sign-On (SSO)
- 🗂️ LDAP & Active Directory
-
🟦 Microsoft Entra ID
- ↳ 📥 Importing people and groups
- ↳ 💻 Intune: assets to their primary user
- ↳ 🏢 Organisation chart
- ↳ 🛠️ Entra directory sync — Developer Guide
- ↳ 🛠️ Entra import - review (#235)
- ↳ 🛠️ Entra follow-ups - review (#237-#240)
- ↳ 🛠️ Intune primary user - review (#236)
- ↳ 🛠️ Intune after an Entra import - review (#334)
- ↳ 🛠️ Intune primary user history - review (#338)
- ↳ 🛠️ Intune asset types - review (#339)
- ↳ 🛠️ Intune scheduled syncs - review (#344)
- ↳ 🛠️ Microsoft 365 in Integrations - review (#352)
- ↳ 🛠️ Organisation chart - reviews (#242, #265)
- 📇 CardDAV contact sync
- Browser Extension
- API Reference
-
🔌 REST API — how it works
- ↳ 📜 Script library (PowerShell + Python)
- ↳ 📋 Proposal: custom fields, inventory import and change evidence (#194)
- ↳ 🛠️ Custom fields, evidence + inventory - review (#195-#197)
- ↳ 🛠️ Long forms in a task's Work view - review (#198)
- ↳ 🛠️ Empty Procedures fold - review (#247)
- ↳ 🎫 REST API: Tickets
- ↳ 💻 REST API: Assets
- ↳ 🔴 REST API: Problems
- ↳ 🟠 REST API: Changes
- ↳ 📚 REST API: Knowledge
- ↳ ✅ REST API: Tasks
- ↳ 🗄️ REST API: CMDB
- ↳ 📜 REST API: Contracts
- ↳ 🗓️ REST API: Calendar
- ↳ 💿 REST API: Software
- ↳ 🌐 REST API: Domains
- ↳ 🚦 REST API: Service Status
- ↳ ☀️ REST API: Morning Checks
- ↳ 📝 REST API: Forms
- ↳ ⚙️ REST API: Workflow
- ↳ 🏷️ REST API: Cost centres
- ↳ 🏢 REST API: Companies
- ↳ 📒 REST API: Chart of accounts
- ↳ 📁 REST API: Projects
- ↳ 🛡️ API threat protection
- ↳ 🧑💼 REST API: Analysts
- ↳ 🗺️ REST API: Network Mapper
- ↳ 🧭 Using the API docs page
- ↳ 📐 OpenAPI specification
- ↳ ✅ OpenAPI: kept correct
- ↳ 🛠️ Maintaining the catalogue
- Watchtower
-
Tickets
- ↳ Reply subject and replying to one message
- ↳ 🔄 Live updates
- ↳ 🛠️ Watching a ticket - Developer Guide (1 of 2)
- ↳ ✉️ Ticket address suggestions - Developer Guide
- ↳ 🛠️ CSAT delay and reminder - Developer Guide
- ↳ 🛠️ Ticket checklist step types - Developer Guide (1 of 2)
- ↳ 🛠️ Right-click Attach checklist - Developer Guide
- ↳ 🛠️ Checklists in the REST API - Developer Guide
- ↳ 🔗 A ticket's related block and attachments - Developer Guide
- ↳ 🛠️ Inbox.js map — Developer Guide
- ↳ 🛠️ Floating windows & the file viewer — Developer Guide
- ↳ 🛠️ Tickets settings — Developer Guide
- ↳ 📐 Simpler ticket and task forms - design (#218)
- ↳ 🗂️ The ticket workspace
- ↳ 📋 Forms on tickets
- ↳ 📊 The ticket table
- ↳ 📋 Rota copy and paste — Developer Deep Dive
- ↳ ✅ Checklists & SOPs
- ↳ ☑️ Mandatory fields
- ↳ 🧾 Custom ticket fields
- ↳ 🏷️ Ticket categories
- ↳ 🧾 A type for every new ticket
- ↳ 👥 Assigning tickets to a team, and escalation
- ↳ 🏢 One board across every company
- ↳ 🔎 Many companies: searchable lists (#358)
- ↳ 📊 Ticket dashboard — Developer Guide
- ↳ Mailbox Authentication
- ↳ 📤 Email send log
- ↳ ✉️ Emailed reports
- ↳ 📎 Attachment size limits and large emails
-
↳ Basic IMAP mailboxes
- ↳ 📐 Basic IMAP without the PHP extension (#257)
- ↳ 🛠️ Basic IMAP client — Developer Guide
- ↳ 🧪 Basic IMAP client — Testing and verifying
- ↳ 🛠️ Basic IMAP - Sent copy - Developer Guide (#270)
- ↳ 📤 PR #400 Sending through a relay without a login
- ↳ 🛠️ Verifying a mail folder — Developer Guide
- ↳ 🛠️ Mailbox providers — Developer Guide
- ↳ 🛠️ How Gmail mail collection works — Developer Guide
- ↳ Email rendering & images
- ↳ SLA Management
- ↳ WhatsApp channel
-
↳
✈️ Telegram channel - ↳ ⭐ CSAT company scope and filters — Developer Guide
- ↳ 👥 Microsoft Teams channel
- ↳ 🗨️ Mattermost channel
- ↳ 💬 Web chat channel
- ↳ 🟣 Slack channel
- ↳ 🔗 Linking tickets
- ↳ ⓘ Record previews
- ↳ 📝 Ticket notes: internal or shared
- ↳ 🗒️ Canned responses
- ↳ ✉️ Limiting replies to particular senders
- ↳ 📨 Telling the analyst a ticket is theirs
- ↳ ✍️ Email signatures
- ↳ 🌐 The public web address
- ↳ 🔢 Ticket numbering
- ↳ 🙋 Raising a ticket for someone else
- ↳ 🔀 Merging tickets
- ↳ 🔒 Confidential tickets
- ↳ 👥 Portal managers
- ↳ 👁 Who has seen a ticket
- ↳ 📜 Reading long tickets
- ↳ ✨ Reply Cleanup prompt and history
- ↳ ⑂ Splitting tickets
- ↳ ✅ Selecting several tickets
- ↳ 🗂️ The folder pane
- ↳ 🔽 Just my tickets, or no closed ones
- ↳ 🛠️ Snoozing tickets — Developer Guide
- ↳ 👥 Collision detection
- ↳ ⏱️ Time tracking
- ↳ 📄 Case reports - a ticket and its work as one PDF
- ↳ 📅 Scheduled work in your own calendar
- Problem Management
-
Tasks
- ↳ 🛠️ Task ID and hover card - review (#405)
- ↳ 🛠️ Task ID, Company column and hover card — Developer Guide
- ↳ 🛠️ Task board and subtasks — Developer Guide
- ↳ 🧑🤝🧑 People on a task ("Involved")
- ↳ 🔁 Repeating tasks
- ↳ 🏢 Moving a task between companies
- 🚀 Projects
-
Assets
- ↳ 🛠️ Asset list by type - review (#340)
- ↳ 🏢 Moving an asset between companies
- ↳ 📍 Shared asset locations
- ↳ 🧑💼 Assigning assets to analysts
- ↳ 📆 Warranty and lease alerts
- ↳ 📄 Leases
- ↳ 🔭 Saved table views
- ↳ 🖨️ Recording anything, and importing it
- ↳ 🧩 Asset type layouts
- ↳ 🕒 Inventory freshness
- ↳ 🔗 Linked configuration item
- ↳ 🔌 Connected assets
- ↳ 🔍 Asset review
- ↳ 📋 Missing information
- ↳ 📦 Consumables
- ↳ 🏷️ QR asset labels
- ↳ 📋 Who holds what, and handover documents
- ↳ 🖥️ The inventory agent (PowerShell)
- ↳ 🗄️ Proxmox VE servers
- ↳ ☁️ VMware Cloud Director servers
- ↳ 🪟 Hyper-V and Failover Clusters
- ↳ 🔗 Linking equipment to tickets
- ↳ ☑️ Follow-up tasks on a ticket
- Knowledge
- Change Management
- Calendar
- Morning Checks
- Reporting
- Software
-
Forms
- ↳ 🎨 The form designer — Developer Guide
- ↳ 📐 Layout & the grid — Developer Guide
- ↳ 🗂️ Collections — grouping submissions
- ↳ 📄 Submissions as PDFs
- ↳ ⚡ What happens next — a form's own actions
- ↳ 🛠️ Sections & conditional logic — Developer Guide
- ↳ 🛠️ Lookup fields — Developer Guide
- ↳ 🛡️ Catalogue request approvals
- People
- Starters & leavers
- Domains
- 🗂️ Files
- Contracts
- Service Status
- 🔔 Notifications
- 🚨 War Room
-
Self-Service Portal
- ↳ 🎨 Branding the portal
- ↳ 🙋 What people can do
- ↳ 📚 Help Centre
- ↳ 🚪 Landing page
- ↳ 🎨 Login screen designer
- ↳ 🛠️ Back to your page after sign-in - review (#407)
- ↳ 🛠️ Back to your page after sign-in — Developer Guide
- ↳ 🛒 Request catalogue
- ↳ 🔒 Portal privacy
- ↳ 👥 Portal managers
- ↳ 📇 Contact details
- ↳ 🛠️ Developer guide
- LMS
- Process Mapper
-
CMDB
- ↳ 🧱 Designing your CMDB
- ↳ 🛠️ CMDB — Developer Guide
- ↳ 🛠️ Impact analysis — Developer Guide
- ↳ 🛠️ Data quality — Developer Guide
- ↳ 🛠️ Record references — Developer Guide
- ↳ 🛠️ CMDB assistant - Developer Guide
- ↳ 🔗 Linked assets
- ↳ 📐 Linking an asset to its CI - design (#201)
- ↳ 📐 Discovery and redundancy-aware impact - design (#199)
- ↳ 🛠️ Relationship wording - review (#297)
- Network Mapper
-
Workflows
- ↳ 🔀 Branches: If / Otherwise and Choose by value
- ↳ 🛠️ Workflow engine — Developer Guide
- ↳ 🛠️ Workflows for tasks — Developer Guide
- ↳ 🛠️ Workflow notes on a ticket — Developer Guide
- ↳ 🛠️ Workflow category routing — Developer Guide
- ↳ 📐 Workflows in order, child tickets - design (#304)
- ↳ ⏰ Time-Based Triggers
- ↳ 🪝 Webhooks
- ↳ 💬 Webhook Message Formats
- ↳ 🔒 HTTPS Certificates & CA Bundles
- ↳ 🛠️ SSL Verification — the Global Setting
- ↳ 🐞 Workflow & Webhook Pitfalls
- Issue trackers (Jira, Azure DevOps)
- 📡 Zabbix (monitoring)
- 💬 Microsoft Teams alerts
- 📞 3CX (phone system)
-
System
- ↳ 🛠️ System cards by topic - review (#347)
- ↳ 🟦 Microsoft 365 (Entra ID and Intune)
- ↳ 🛠️ Preferences — Developer Guide
- ↳ 🗂️ Settings on one page
- ↳ 🧹 Maintenance
- ↳ 💾 Storage usage
- ↳ ✉️ Emailed reports
- ↳ 🔎 Finding people in the Analysts list
- ↳ 🚪 When an analyst leaves
- ↳ 🛠️ System → Branding — Developer Guide
- ↳ 🩺 Page health (D019) — Developer Guide
- ↳ ⭐ Feature Bingo
- ↳ 📍 Locations
- ↳ 🏷️ Cost centres
- ↳ 📒 Chart of accounts
- ↳ 📷 Photo Album
- ↳ Demo Data
- ↳ 🛠️ Demo Data — Developer Guide
-
Overview
- ↳ 📊 Progress tracker
- ↳ Concepts & vocabulary
- ↳ Email routing & mailboxes
- ↳ Settings: global vs per-company
- ↳ Users & self-service
- ↳ Staff cross-company access
- ↳ One company supporting another
- ↳ 🏢 One board across every company
- ↳ Worked examples
- ↳ Pitfalls & gotchas
- ↳ Scope: what it's for
- ↳ 🛠️ Developer Guide (make a module multi-company)
- ↳ 🗄️ Case study: CMDB (a linked graph)
- ↳ 🧪 Test harness (prove it's isolated)
- What this is
-
🐞 Bugs resolved
- ↳ 📖 #413 Reading pane too narrow on tablets
- ↳ 📱 #412 Sign-in card cramped on phones
- ↳ 🧭 #411 Header buttons out of reach
- ↳ 💱 #386 Project stuck in an old currency
- ↳ 🖥️ #393 Header ran off the screen
- ↳ 🖱️ #395 Ticket flyouts ran off the bottom
- ↳ 🔁 PR #401 Change editor used hardcoded priorities
- ↳ 📝 Knowledge drafts could not be published
- ↳ 🧩 #392 Project dialogs shared element ids
- ↳ 🖼️ #391 Knowledge images from your computer
- ↳ 🕗 #375 REST API wall-clock times
- ↳ 📅 #374 Calendar popup ran off the screen
- ↳ 🏢 #373 All companies: Changes, CMDB, Starters
- ↳ 🏢 #356 Assets People and All companies
- ↳ 🎓 #366 LMS demo data would not import
- ↳ 🔔 #362/#365 Team handover showed only a name
- ↳ 🔔 #365 The bell credited the wrong person
- ↳ 🗄️ #369 Inbox empty until Database Verification
- ↳ 🪆 #360 Links opened inside the ticket
- ↳ 🔗 #354 Workspace Links missed tasks
- ↳ 🔒 Task company checks in the API (5.5.0)
- ↳ 🔒 Asset holders through the API (5.4.0)
- ↳ 🔒 Files folder delete did not check inside (5.4.0)
- ↳ 🔒 The Intune tab did not check the company
- ↳ 📂 #332 Files viewer would not open
- ↳ 📎 #333 Note attachments downloaded
- ↳ 🪝 #326/#327 Form webhook Full record
- ↳ 📄 #325 Form PDF download failed
- ↳ 🔁 Small fixes in 5.1.0
- ↳ 🔁 CMDB relationships read backwards (5.1.0)
- ↳ 🔁 #301 CSAT delay was never applied
- ↳ 🔁 #281 Comments imported from Jira never arrived
- ↳ 🔁 #288 A change failed to open with Enforce approvals on
- ↳ 📚 Long non-Latin articles never got an embedding
- ↳ 🎫 #280 Email lookups scanned the whole table
- ↳ ✅ #266 Dragging a task told nobody
- ↳ 📚 #255 Article previews showed HTML codes
- ↳ 📚 #252 A link to a Knowledge article did not open
- ↳ 📄 #254 PDFs could not print Polish
- ↳ 📚 #250 Clicking a folder left the open article on screen
- ↳ 🎫 #260 The dashboard cog did nothing
- ↳ 🎫 #248 A department rule never matched on four routes
- ↳ 🔒 A directory account could be matched to someone else
- ↳ 🎫 #244 Reply went to the assigned analyst
- ↳ 🔒 Mailbox sign-in was not checked
- ↳ 🔒 Four weaknesses around signing in
- ↳ 🔒 A lookup answer could name any record
- ↳ 🎫 #227 A mailbox could not be deleted
- ↳ 🎫 #226 A picture on a note could not be closed
- ↳ 💻 #222 The Assets page never loaded in 4.3.0
- ↳ ⚙️ #214 A "contains" condition did not match capitals
- ↳ ⚙️ #216 A workflow email from a chosen mailbox always failed
- ↳ 🐳 The Docker image was missing PHP extensions
- ↳ 🌐 A failed DNS lookup read as a missing record
- ↳ 🔒 A link could change data
- ↳ 🔒 Access outlived its removal
- ↳ 🔒 Knowledge articles could run scripts
- ↳ 🔒 Knowledge writes ignored permissions
- ↳ 🔒 Company boundaries (Oct 2026)
- ↳ 🔒 Smaller gaps (Oct 2026)
- ↳ 🔒 Escaped text could leave its attribute
- ↳ 🔒 Task descriptions were not cleaned
- ↳ 🔒 Task documents ignored company scope
- ↳ 🔒 Repeating tasks ignored company scope
- ↳ 📬 #183 Mailbox checks overlapped
- ↳ 🌐 #188 Transfer lock shown off when unknown
- ↳ ✅ #184 Subtask names and Overdue
- ↳ 🧩 #186 Teams: the buttons did nothing
- ↳ 🔒 Text in a change could run script
- ↳ 🔒 AI settings changed without the AI permission
- ↳ 🚪 #178 Deleting an analyst failed
- ↳ 🎫 A team with no departments showed 0 tickets
- ↳ 🚀 Projects: adding a phase did nothing on Save
- ↳ 🔒 Leavers could still sign in
- ↳ 🖼️ Logo and courses broke on Apache with PHP-FPM
- ↳ 🔢 Chat tickets ignored your ticket numbering
- ↳ 📅 Dates shown as a dash, or in server time
- ↳ 🔒 Assets → Users showed people from other companies
- ↳ 🔒 Restricted analysts could read other modules' data
- ↳ 🖼️ Replies with a picture in the thread failed to send
- ↳ 📎 Reply attachments never reached the customer
- ↳ 🛠️ Outbound email attachments — Developer Guide
- ↳ 🔑 A global SSO provider was missing from the portal
- ↳ 🔀 Behind a proxy, the SSO redirect said http
- ↳ ✏️ The portal tagline moved when you saved it
- ↳ 🎨 The portal settings screen forgot what you saved
- ↳ 🛡️ The approvals inbox said "Error" and nothing else
- ↳ 📄 A table's answers were missing from the PDF
- ↳ ◉ A single-select column let you tick every option
- ↳ 📐 The portal ignored a form's field widths
- ↳ 📋 The tasks board stopped taking clicks
- ↳ 🗂️ #121 The index list is out of date after upgrading
- ↳ 📅 #133 The calendar subscription was empty
- ↳ 📋 #131 Tasks always reopened on the board
- ↳ 💥 #129 Every page returned HTTP 500 after upgrading
- ↳ 🐳 #127 A PHP warning above the System page
- ↳ 🕐 #126 Notes stamped with the server's clock
- ↳ 🌍 Storing every date in UTC
- ↳ 🚪 The portal was down for everyone signed in
- ↳ ⚙️ #120 Workflow notes could never be written
- ↳ ⚙️ #123 Three errors when running Database Verification
- ↳ 📝 #122 The description box was a stub in the corner
- ↳ 💣 Demo data deleted real accounts
- ↳ 🔐 #117 Sign-in redirected to the wrong address
- ↳ 🎨 #108 The priority dot was invisible
- ↳ ⏱️ #116 Time logged from the right-click menu
- ↳ 🔑 #114 API keys refused by our own guard
- ↳ 🗂️ #110 Assigning a task told nobody
- ↳ 🚪 #107 Signed out while still working
- ↳ 📎 #103 "Share with Requester" reached nobody
- ↳ 🔍 #102 Search found nothing for hyphens
- ↳ 🪟 #101 Source code editor opened behind
- ↳ ☑️ #88 Subtasks could not be ticked off
- ↳ 💻 #84 Asset deep link selected nothing
- ↳ 🎫 #79 A new ticket arrived with no status
- ↳ 📧 #79 A ticket from email did not say so
- ↳ 🔔 #78 Bell opened to nothing
- ↳ 📬 #77 Mail only collected from Inbox
- ↳ 🔐 #74 The default password could not be changed
- ↳ 🚦 #70 Renaming an impact level
- ↳ 📤 #67 App-only mailboxes could not send
- ↳ 📭 #45 Verify only ever worked for Microsoft
- ↳ 📭 #45 IMAP reported as not authenticated
- ↳ ✉️ An email template stopped escaping itself
- ↳ 🕐 The portal dashboard showed the wrong time
- ↳ 🔢 The folder said 99 and the list showed 96