harly update
does this for you.
Upgrading to 0.3.0
0.3.0 redesigns the product and adds an MCP server for AI agents, an in-app updater, native e-signature and document generation, and rejection reasons.Migrations
The container applies six additive migrations (0159–0164) on start. Nothing
is dropped, renamed, or rewritten destructively, so a 0.2.4 process keeps
working while they run. Migrations wait at most 30 seconds for a table lock
(HARLY_MIGRATION_LOCK_TIMEOUT_MS).
Behavior changes
- Rejecting asks for a reason. Seven default reasons are created on first use; manage them in Settings → Company & brand. REST and AI callers that send no reason record “Other” and still send the rejection email.
- MCP is on and members can connect agents.
mcp:useis added to the built-in Recruiter and Hiring manager roles andmcp:manageto Admin. Custom roles saved before 0.3.0 that were based on those roles inheritmcp:use. To forbid agents, switch MCP off in Settings → AI agents (MCP) or removemcp:usefrom a role. An agent never has more access than the person who connected it. - E-signature reminders follow the workspace cadence and cap (every 3 days, at most 3), measured from the current signer’s invite. Configure them in Settings → Harly Signature.
- Public pages. The career page builder, Showcase template, candidate portal, and signing pages are redesigned. Stored career page configurations still parse. Check your published page once.
- AI scoring drops evidence quotes it cannot find in the resume, uses a job’s published rubric for every candidate, and re-scores only when the engine version changes. Scores may differ slightly from 0.2.4; use Regenerate if needed.
- Harly AI uses a shorter prompt and routes tools per turn, which lowers
usage and cost.
HARLY_AI_TOKEN_DEBUG=1logs a per-step token breakdown.
New environment variables
All are optional; see configuration forHARLY_RELEASE_MANIFEST_URL, HARLY_DISABLE_UPDATE_CHECK,
HARLY_UPDATER_INTERVAL, and MCP_ALLOWED_ORIGINS. Installations created by an
older harly init keep their own compose.yaml, and harly update does not
rewrite it. Add these lines to the shared environment block of the app
service to use the variables:
DocuSeal image is pinned
With the optionalesign profile, compose.yaml pulls
docuseal/docuseal:3.3.4 instead of :latest. Override it with
HARLY_DOCUSEAL_VERSION in .env when you decide to upgrade DocuSeal. An
installation with an older compose.yaml keeps the tag that file names. To pin
the other base images by digest, see
pinning third-party images.
Reverse proxy: let /mcp stream and cap request bodies
The MCP endpoint can reply with a server-sent event stream. The proxy must not
compress or buffer it, and /mcp, /oauth/*, and /.well-known/* must be
reachable without a Harly session. The bundled Caddyfile is updated. If you
maintain your own, use:
client_max_body_size 30m;, and add proxy_buffering off; gzip off; to the
/mcp location. With Cloudflare, do not challenge /mcp, /oauth/*, or
/.well-known/*. Claude and ChatGPT connect from the provider’s servers, so
Harly must be reachable over HTTPS from the internet. See
Connect AI agents.
Install the updater (optional)
Settings → Updates is visible to owners from the first start and shows “The server updater is not running” until you install the host service:sudo to write and start the systemd unit directly. Without
systemd, run harly updater run under any supervisor, or
harly updater run --once from cron every minute. The updater derives its token
from CRON_SECRET; no new secret is needed. Render, Railway, Fly.io, and
DigitalOcean update by pointing the service at the new image tag, and the
updater does not apply. Auto-updates are off by default and install only patch
or minor releases inside the window you set.
Known limitations
- Rollback. A 0.2.4 image runs against the 0.3.0 schema because every change
is additive, but it does not understand
datesignature fields or the new reminder settings. Restore the pre-update backup if you must roll back after sending documents with date fields. - Existing rejections have no reason.
- MCP connections end 90 days after approval and must be approved again.
- MCP is not available in the public demo sandbox.
- REST API authorization is unchanged; see API authorization.
After upgrading
- Decide in Settings → AI agents (MCP) whether MCP stays on and which clients may connect.
- Review Settings → Roles for
mcp:useandmcp:manage. - Open your published career page and the candidate portal once.
- Install the updater if you want in-app updates.
- Run
harly doctorto confirm the scheduler and migrations are healthy.
Upgrading to 0.2.4
0.2.4 changes how pipeline stages are modelled, how reports are computed, and who can see what.Migrations
The container applies six additive migrations (0153–0158) on start.
- Migrations wait at most 30 seconds for a table lock and then fail with a
readable message instead of blocking traffic.
0disables the limit. - A stage whose
kindis stillNULL(written by a 0.2.x process during a rolling upgrade) is classified by its legacy name at read time. - Stage names that differ only by case or whitespace are left alone; renaming or archiving one resolves the duplicate.
Behavior changes
- Gravatar is off. An owner or admin can re-enable it in Settings → Company.
- Exports need
dsar:manage. The consent report and the audit-log export (which also needssecurity:manage) no longer key off the owner/admin role. Owners, admins, and the default Recruiter role holddsar:manage; grant it to custom roles in Settings → Roles. - Role scope is enforced everywhere. Roles limited to specific jobs, departments, or regions see only in-scope data in the UI, AI tools, and AI write actions. Reports are not available to such roles yet.
- Scheduled reports run only while their creator is still a member with
reports:readand an unrestricted scope; otherwise the run is recorded as skipped with a reason. - REST API. Publishable (
pk_) keys can create applications and read jobs only;move,reject,hire, andbulkneed a secret key. Creating a key from the UI requires the permission behind every requested scope. Keys remain workspace-wide and do not follow role scope. - Search recents are per user and workspace, expire after 30 days, and are cleared on sign-out.
- Email. Messages the provider accepted are never retried; an SMTP timeout or reset after connecting is an unknown outcome to retry manually from the delivery log. Events in flight at upgrade time may be delivered once more.
- AI anonymization also covers Harly AI chat tool results; replies use a per-conversation pseudonym.
- Demo instances must set
DEMO_WORKSPACE_IDwhenDEMO_MODEis on. - A hire withdraws the candidate’s other applications through the normal
withdrawal path (history,
application.withdrawnevents, webhooks).
Known limitations
- Rollback. Rolling back to a 0.2.x image is supported only if no stage has been archived or reclassified. Otherwise restore from backup.
- Legacy hire dates. Hires before 0.2.4 without a stage-history row are dated by their last activity event, so report dates may differ.
- Reports are unavailable to role-scoped users.
- Auth screens always use the light theme.
- The Zoom refresh token is kept in memory if the database write fails after a rotation; a restart before the next successful write requires reconnecting Zoom.
After upgrading
- Review any integration reported as needs reconnect or degraded in Settings → Integrations.
- Open a job’s pipeline and use Edit stages to confirm stage kinds, especially custom-named hired and rejected stages.
- Grant
dsar:managewhere needed. - Check the delivery log for messages marked unknown outcome.
- Run
harly doctor.