Breaking changes
- Require webserver.url for every server configuration. Before upgrading, set webserver.url or CHATTO_WEBSERVER_URL to the public HTTP or HTTPS URL of the server. Chatto rejects missing or blank values at startup. (#3624)
- The bundled frontend now hides the Server Gutter and the Server Directory by default and shows only the server that serves it. To let users add and switch between other Chatto servers again, set
frontend.gutter.enabled = trueorCHATTO_FRONTEND_GUTTER_ENABLED=true. The standalone frontend and the desktop app are not affected. (#3617)
Features
-
The sidebar header now has a server menu with Server information, Copy server link, Mark as read, and Sign out. Settings also shows Sign out of server in the Your account section. (#3617)
-
Open Help from the app header for guides to using Chatto, formatting messages, setting up bots, and installing Chatto on your phone. The guides and navigation are available in all supported languages. (#3566)
-
Suitable uploaded videos now retain their original quality up to 1080p without another server video encode. Smaller streaming renditions and thumbnails remain available, and incompatible files use the existing encoding path. (#3597)
-
Automatically compress oversized videos locally before upload. The existing attachment tile shows compression progress, then upload progress. Removing the tile cancels processing. This experimental feature requires supported browser codecs, keeps the source file unchanged, preserves the primary audio track, and checks the output size before upload. (#3595)
-
Call controls now stay in the app header as you navigate between rooms and servers. Joining another call in the same app session disconnects the previous call first. (#3568)
-
Refined the call controls in the app header and the call panel:
- The header names the call's room, with a status dot that glows while you speak and warns about a poor or lost connection. With more than one server, the server's icon comes first.
- Microphone, camera, and screen share show a green icon while they send media and a slashed icon while off, instead of bright green buttons.
- Leave call shows a red icon instead of a red button.
- The header buttons are flat and larger on touch devices.
- Screen share is hidden in browsers that cannot share a screen.
(#3729)
-
Standalone search providers (
chatto search-provider) can serve/livez,/readyz, and/metricson a separate health listener. Enable it with[search_provider.health]. Liveness stays healthy while the provider builds its index, and readiness succeeds only while the provider answers queries. Withdiagnostics = true, the listener also serves goroutine stacks, profiles, and index diagnostics to local connections. Each provider now checks its own index with a regular test query. While this query fails or blocks, the provider stops answering queries so that other providers answer them. Blocked index work no longer blocks provider shutdown indefinitely. (#3669) -
MCP agents can now look up public user profiles by user ID or username. OAuth clients must request the new
chatto:profile:readscope and obtain fresh consent to use profile lookup. (#3552) -
Standalone frontend containers can now publish their OAuth client metadata at startup. Set CHATTO_FRONTEND_ORIGIN to the public HTTPS origin to enable remote Chatto sign-in without a separate metadata file. (#3622)
-
After first-run setup, Chatto signs the new owner in, activates Shield Mode for 15 minutes, and shows a welcome dialog that explains Shield Mode and links to the first configuration tasks. (#3636)
-
The # picker in message composers now includes known servers and available rooms across servers. Servers show their logos. Rooms on other servers show their server name after the room name. (#3592)
-
People can now sign in with an internet handle: the handle of an AT Protocol account, such as a Bluesky account.
- Operators enable sign-in with a new
atprotologin provider type. It needs no client registration or secret. See the login providers guide. - The login page shows the provider like other providers. The sign-in window then asks for the person's handle.
- Chatto requests only the AT Protocol identity permission and gets no access to people's posts or other data.
- New accounts start with the display name and avatar of the person's public AT Protocol profile.
- On other servers, the sign-in screen offers Continue as @handle for the handle that the device used last.
(#3603)
- Operators enable sign-in with a new
-
Standalone frontend containers now publish a page title, description, and link-preview image. The defaults describe Chatto. Set CHATTO_FRONTEND_TITLE, CHATTO_FRONTEND_DESCRIPTION, or CHATTO_FRONTEND_IMAGE to change them; set CHATTO_FRONTEND_ORIGIN so that previews can use absolute URLs.
Standalone frontend containers can now run on a read-only root file system. Mount writable temporary file systems at /var/cache/nginx and /var/run.
Chatto servers now set the page title and description from the server name and description. (#3635)
-
Try the new message header in App Preferences under Experiments. It shows the author’s @username after their display name. In the timeline, a middot and a smaller, muted timestamp follow the names. The choice is shared across tabs in this browser. (#3712)
-
Add Intel and universal macOS desktop downloads alongside the Apple Silicon builds. Automatic macOS updates install the universal app on both architectures. (#3606)
-
Text files now open in the large file viewer with selectable text, preserved line breaks, and wrapped long lines. (#3596)
-
Chatto now supplies Prometheus alerting rules in
examples/prometheus/chatto-alerts.yml. They report failed search queries, a missing search provider, and stalled search indexes and projections. A slow index rebuild that still makes progress does not fire them. The server metrics now also includechatto_search_provider_query_probe_consecutive_failuresandchatto_search_provider_query_probe_in_flight_seconds, which show the test query of the search provider. Whenchatto runincludes the search provider, its metrics listener now also serves the provider's ownchatto_search_query_probe_*,chatto_search_provider_serving, andchatto_search_index_write_age_secondsmetrics, so that each replica reports its own provider. See the Alert rules section of the server operations guide. (#3672) -
Inspect background jobs in Server Administration → Jobs, and retry or delete failed jobs with the
server.managepermission. The page shows media processing, outbound webhooks, file cleanup, call-key and account-key deletion, push-subscription cleanup, and notification alerts. Webhook deliveries now survive server restarts. Temporary failures retry automatically without holding a worker slot while waiting. Succeeded jobs are kept for three days. Failed jobs stay until someone retries or deletes them; setCHATTO_CORE_JOB_FAILED_RETENTIONto remove them automatically. Each job type has its own worker pool:CHATTO_CORE_JOB_CONCURRENCYsets the pool size of each webhook, cleanup, and key-deletion job type, and notification alerts and media processing have their own sizes.Media processing, file cleanup, and key deletion still retry until they finish, but the delay between attempts now doubles from 30 seconds up to 30 minutes. After a long outage of a tool, the key service, or object storage, waiting work can therefore resume up to 30 minutes after the outage ends.
Do not roll back to an earlier server version while jobs are queued or running. An earlier version does not run jobs that this version has accepted, including account-key deletion; they wait until you upgrade again.
If you run standalone
chatto asset-processingworkers, upgrade them right after the servers. Older workers cannot process media jobs from upgraded servers, and a new worker exits until an upgraded server has created the job stream. (#3598) -
Usernames can contain up to 64 characters by default. Set
core.accounts.max_login_lengthin TOML orCHATTO_CORE_ACCOUNTS_MAX_LOGIN_LENGTHin the environment to choose a limit from 2 to 254 characters. Archive import checks new usernames against the destination limit before it writes any records.Set the verified account quota with
core.accounts.max_usersorCHATTO_CORE_ACCOUNTS_MAX_USERS. Existing quota settings continue to work. (#3690) -
The Room information panel now shows the room's threading mode and slow mode, so members can see these rules before they post. (#3703)
-
Chatto has its own emoji now! 🎉 Every emoji in messages, reactions, the composer, and the emoji picker uses the colorful Twemoji set, so a 👍 or a 🫠 looks the same on Windows, macOS, Linux, iOS, and Android. What you send is exactly what everyone else sees. ✨ (#3710)
-
Members can choose which protected roles to activate in Shield Mode for up to 15 minutes. The event log shows which roles they selected. Role managers can protect individual roles. The
ownerrole always requires activation,everyonegrants apply during ordinary use, and role denies stay in force.After upgrading, review custom roles and direct account grants. Enable Require Shield Mode on roles that need it. To require activation for a direct grant, including a management permission, move it to a protected role.
Bot managers can grant any permission the bot’s owner holds at the same scope, including permissions from inactive protected roles. If the owner loses a permission, the bot’s saved grant becomes inactive. (#3720)
-
MCP agents can now send direct messages by user ID, read and reply to threads, edit or delete messages, and add or remove reactions. These actions use the connected account's Chatto permissions; existing message-write grants include the new messaging actions. (#3552)
Fixes
-
Security: when you sign in to another server, Chatto now confirms that the sign-in response comes from that server. Before, a malicious server could pass your sign-in to a different server where you have an account and get access to that account. Existing sessions stay signed in.
Action for self-hosters: clients with this fix can sign in to your server from the frontend of another server only when your server has
webserver.urlset. This also applies to a server that still runs 0.5, which starts without it in a minimal configuration. Setwebserver.urlto the public address that people use to add your server; you do not have to upgrade the server for this. Sign-in through a different address for the same server now fails, so tell members to add the server with that public address. (#3621) -
@chatto/client/auth/oauthnow refuses an authorization callback without theissparameter of the selected server. It also exportsrandomOAuthValue,pkceCodeChallenge,isExpectedOAuthIssuer, andexchangeAuthorizationCodefor hosts that use their own callback. (#3621) -
Invite-only servers explain when you need an invitation code. During sign-up, Chatto explains how to verify an email address, choose a profile name, or use an existing account after signing in with a provider. The Internet Handle prompt explains which handle to enter and where to approve the sign-in. Sign-in and authorization windows show the server's icon, name, and address in a window bar, and its banner and description above the form. The account confirmation page shows which provider you signed in with. (#3692)
-
Message author names no longer show an underline on hover. (#3616)
-
Loading panels, lists, menus, and dialogs now show quiet pulsing dots instead of an animated shimmer. Images and videos still show the shimmer while they load. (#3676)
-
Mention autocomplete shows matching
@alland@herehandles above weaker member matches in busy rooms. (#3728) -
When you link a sign-in provider on your account’s server, you can confirm your password in Account settings before the provider window opens. (#3689)
-
Make inline message timestamps match room links in shape, text weight, spacing, and icon alignment. (#3610)
-
Fixed member suggestions for
@mentions, which could stop appearing after a reconnect until the Members panel was opened or the app was reloaded. (#3601) -
Chatto no longer shows a "realtime minimum cursor expired" error when a room notice or another resource loads more than 15 minutes after it changed. Requests with an expired
Chatto-Realtime-Minimum-Cursornow run at once instead of failing, in ConnectRPC and MCP. Room notices and the message timeline show a translated error when they cannot load, not the server error text. (#3707) -
The instructions on the Forgot Password page use the same text size as the other sign-in pages. (#3698)
-
Fixed the documentation homepage's Release Notes link to open the Chatto 0.5.0 notes instead of 0.4.0. (#3609)
-
Add a Strikethrough button to the formatting toolbar in both message editors. (#3651)
-
Restyled the Access Denied page with a lock icon, a calmer headline, and a button that takes you back. The screen for rooms you cannot join now uses the same design. (#3730)
-
In the iOS Home Screen app, you can now save PDF attachments and other supported files through the system share sheet. (#3735)
-
When you replace or clear a server logo or banner, a background job removes the old image and its cached sizes. Another server replica can finish cleanup after a restart. You can inspect the job in Server Settings → Jobs. (#3722)
-
Keep Browser default when no time zone is selected. Startup no longer saves the browser time zone as an account preference. Named time zones are saved only after an explicit choice, and time-zone sharing remains a separate opt-in setting. Existing saved time zones can be cleared in Settings to use Browser default. (#3671)
-
Fixed extra space after link pills in the message composer. (#3620)
-
Fixed Escape closing the thread when you dismiss a fullscreen video. Escape also keeps split-layout threads open, as a click outside the thread already does. (#3639)
-
After account deletion, a background job removes the account's stored sessions and access tokens. Another server replica can finish interrupted cleanup. Administrators can see its status on the Jobs page. (#3725)
-
Server logs now show where a Web Push test failed and the HTTP status when the push service responded. (#3709)
-
Fix empty date headers left by hidden timeline events, including joins and leaves from deleted accounts, after the last visible message of a day is deleted. (#3567)
-
Clicking Reply on a message with an existing thread now opens that thread in Enabled rooms too. You can still choose Reply in room from the message menu. (#3551)
-
Markdown emphasis now works on Cyrillic, Arabic, Hebrew, Chinese, Japanese, and accented words in chat messages. Parenthesized glyphs such as
*(x)*remain literal instead of becoming italic text. (#3566) -
Keep image gallery zoom controls visible without flicker when switching images. (#3608)
-
Tab now inserts the highlighted entry in the #, :, and @ composer pickers instead of cycling through matches. Use the arrow keys to move the selection. (#3602)
-
Browser cookies from Chatto 0.4 no longer migrate automatically. Users who did not migrate through Chatto 0.5 must sign in again. Existing Chatto 0.5 browser sessions keep their normal login, renewal, logout, and realtime behavior. (#3579)
-
In
chatto init -i, press Enter on the final review to create the configuration files. Select Cancel to exit without saving. (#3678) -
Page titles use the strongest text colour, so they stand above the panel titles on the page. In Settings, Account has its own key icon, and the Notification policy panel has an icon like the other panels. (#3696)
-
Sign-in, sign-up, and password reset forms sit in the centre of the page or sign-in window, not at its top. The server name and the page title read as one heading. The sign-up page shows sign-in providers above the email form, in the same order as the sign-in page. (#3695)
-
Creating an account with a sign-in provider now happens in the Chatto window that started the sign-in. Before, the provider window stayed open and showed the account confirmation itself. (#3603)
-
Keep permitted attachment management actions visible below the content. Keep video playback controls inside the player and remove its separate viewer opener. Open converted GIFs in the large viewer by clicking the preview. (#3555)
-
Queue registration, email verification, and password-reset mail for delivery in the background. Accepted mail survives restarts and retries temporary transport failures until the code or link expires. Email jobs appear in the Jobs page without addresses or message content. (#3656)
-
Outgoing SMTP email now uses the domain of the configured sender address in its
Message-IDheader instead of the machine hostname. In containers, the hostname is usually a container ID, which can cause receivers such as Gmail to reject the message. You no longer need to set a containerhostnameto work around this. (#3717) -
When the latest room message has a thread and was posted within the last 30 minutes, Chatto now asks whether you want to continue it or start a new conversation. Replies to a specific message keep their chosen destination. (#3551)
-
After a message edit or retraction, a background job securely erases obsolete body records. Another server replica can finish the job if the writer stops. Operators can inspect the job in Server Settings → Jobs. (#3723)
-
Button, checkbox, and radio labels no longer highlight when you drag across them. You can still select help and error text for checkboxes and radio options. (#3711)
-
Add a back arrow to Settings so signed-out users can leave it when the Server Gutter is hidden. (#3693)
-
Hover link previews no longer open or start loading while a context menu is open. (#3593)
-
Use cacheable HTTP GET requests for public server discovery in the client and bundled frontend. Discovery omits credentials and referrers. Chatto 0.4 servers are no longer discoverable; upgrade them to Chatto 0.5.0 or later. The existing minimum connectable server version, 0.5.0-beta.9, is unchanged. (#3574)
-
Fixed server, room, user, and message link pills not appearing when a URL is immediately followed by a colon. (#3591)
-
A search provider whose index stops advancing now reports a degraded state instead of ready, and Admin → System shows stalled projections as a warning. New metrics report projection and search index stalls, waiting time, and the duration of the current and last index work:
chatto_projection_stalled,chatto_projection_pending_seconds,chatto_projection_current_operation_seconds,chatto_projection_last_commit_timestamp_seconds,chatto_projection_last_commit_duration_seconds, and thechatto_search_provider_*family. Chatto logs a warning when a projection stalls and when it recovers. (#3668) -
Fixed network errors on a weak connection that needed a manual "Try Again" and showed no connection warning. Chatto now repeats failed reads up to two times, parts that failed to load try again without the user, and the header shows the connection warning of the current server when requests fail.
Writes do not retry automatically, because the server can have accepted a write before its response was lost. (#3642)
-
Add Odin syntax highlighting to message code blocks and the code language selector in the bundled web and desktop clients. (#3634)
-
Slow Mode and Threading Mode now use consistent names across the app. Norwegian and Polish also use one term for Slow Mode everywhere. (#3704)
-
Sign-in with providers whose pages isolate the sign-in window, such as Bluesky, no longer stops silently. Chatto now waits for the result, and the waiting notice has a Cancel button. All sign-in windows are also larger, so provider pages such as Bluesky's fit without scrolling.
Closing the sign-in window in Chatto Desktop lets you try again immediately, including when the provider isolates its page. Browser tabs also detect closure while Chatto prepares the sign-in URL. On the login and registration pages, select Try Again to reopen provider sign-in in one click, including in an installed web app. (#3603)
-
Thread badges now show only users who replied. The thread pane header also includes the original message author, without duplicates. (#3572)
-
Hide the Create Account link on the sign-in page when direct registration is disabled. Sign-in providers remain available. (#3657)
-
Server replicas now share Neighborhood refresh jobs. If the replica that schedules a refresh stops, another replica can finish it. Server administrators can see refreshes on the Jobs page. (#3724)
-
The Account, Profile, Composer, and Voice & video settings pages show their panels in two columns on wide windows. Before, each panel used the full width and its right half was empty. (#3697)