2 All notable changes to this project will be documented in this file.
4 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
6 ## [2.1.0] - 2020-08-28
10 - **Breaking:** The default descriptions on uploads are now empty. The old behavior (filename as default) can be configured, see the cheat sheet.
11 - **Breaking:** Added the ObjectAgePolicy to the default set of MRFs. This will delist and strip the follower collection of any message received that is older than 7 days. This will stop users from seeing very old messages in the timelines. The messages can still be viewed on the user's page and in conversations. They also still trigger notifications.
12 - **Breaking:** Elixir >=1.9 is now required (was >= 1.8)
13 - **Breaking:** Configuration: `:auto_linker, :opts` moved to `:pleroma, Pleroma.Formatter`. Old config namespace is deprecated.
14 - **Breaking:** Configuration: `:instance, welcome_user_nickname` moved to `:welcome, :direct_message, :sender_nickname`, `:instance, :welcome_message` moved to `:welcome, :direct_message, :message`. Old config namespace is deprecated.
15 - **Breaking:** LDAP: Fallback to local database authentication has been removed for security reasons and lack of a mechanism to ensure the passwords are synchronized when LDAP passwords are updated.
16 - **Breaking** Changed defaults for `:restrict_unauthenticated` so that when `:instance, :public` is set to `false` then all `:restrict_unauthenticated` items be effectively set to `true`. If you'd like to allow unauthenticated access to specific API endpoints on a private instance, please explicitly set `:restrict_unauthenticated` to non-default value in `config/prod.secret.exs`.
17 - In Conversations, return only direct messages as `last_status`
18 - Using the `only_media` filter on timelines will now exclude reblog media
19 - MFR policy to set global expiration for all local Create activities
20 - OGP rich media parser merged with TwitterCard
21 - Configuration: `:instance, rewrite_policy` moved to `:mrf, policies`, `:instance, :mrf_transparency` moved to `:mrf, :transparency`, `:instance, :mrf_transparency_exclusions` moved to `:mrf, :transparency_exclusions`. Old config namespace is deprecated.
22 - Configuration: `:media_proxy, whitelist` format changed to host with scheme (e.g. `http://example.com` instead of `example.com`). Domain format is deprecated.
25 <summary>API Changes</summary>
27 - **Breaking:** Pleroma API: The routes to update avatar, banner and background have been removed.
28 - **Breaking:** Image description length is limited now.
29 - **Breaking:** Emoji API: changed methods and renamed routes.
30 - **Breaking:** Notification Settings API for suppressing notifications has been simplified down to `block_from_strangers`.
31 - **Breaking:** Notification Settings API option for hiding push notification contents has been renamed to `hide_notification_contents`.
32 - MastodonAPI: Allow removal of avatar, banner and background.
33 - Streaming: Repeats of a user's posts will no longer be pushed to the user's stream.
34 - Mastodon API: Added `pleroma.metadata.fields_limits` to /api/v1/instance
35 - Mastodon API: On deletion, returns the original post text.
36 - Mastodon API: Add `pleroma.unread_count` to the Marker entity.
37 - Mastodon API: Added `pleroma.metadata.post_formats` to /api/v1/instance
38 - Mastodon API (legacy): Allow query parameters for `/api/v1/domain_blocks`, e.g. `/api/v1/domain_blocks?domain=badposters.zone`
39 - Mastodon API: Make notifications about statuses from muted users and threads read automatically
40 - Pleroma API: `/api/pleroma/captcha` responses now include `seconds_valid` with an integer value.
45 <summary>Admin API Changes</summary>
47 - **Breaking** Changed relay `/api/pleroma/admin/relay` endpoints response format.
48 - Status visibility stats: now can return stats per instance.
49 - Mix task to refresh counter cache (`mix pleroma.refresh_counter_cache`)
55 - **Breaking:** removed `with_move` parameter from notifications timeline.
59 - Frontends: Add mix task to install frontends.
60 - Frontends: Add configurable frontends for primary and admin fe.
61 - Configuration: Added a blacklist for email servers.
62 - Chats: Added `accepts_chat_messages` field to user, exposed in APIs and federation.
63 - Chats: Added support for federated chats. For details, see the docs.
64 - ActivityPub: Added support for existing AP ids for instances migrated from Mastodon.
65 - Instance: Add `background_image` to configuration and `/api/v1/instance`
66 - Instance: Extend `/api/v1/instance` with Pleroma-specific information.
67 - NodeInfo: `pleroma:api/v1/notifications:include_types_filter` to the `features` list.
68 - NodeInfo: `pleroma_emoji_reactions` to the `features` list.
69 - Configuration: `:restrict_unauthenticated` setting, restrict access for unauthenticated users to timelines (public and federate), user profiles and statuses.
70 - Configuration: Add `:database_config_whitelist` setting to whitelist settings which can be configured from AdminFE.
71 - Configuration: `filename_display_max_length` option to set filename truncate limit, if filename display enabled (0 = no limit).
72 - New HTTP adapter [gun](https://github.com/ninenines/gun). Gun adapter requires minimum OTP version of 22.2 otherwise Pleroma won’t start. For hackney OTP update is not required.
73 - Mix task to create trusted OAuth App.
74 - Mix task to reset MFA for user accounts
75 - Notifications: Added `follow_request` notification type.
76 - Added `:reject_deletes` group to SimplePolicy
77 - MRF (`EmojiStealPolicy`): New MRF Policy which allows to automatically download emojis from remote instances
78 - Support pagination in emoji packs API (for packs and for files in pack)
79 - Support for viewing instances favicons next to posts and accounts
80 - Added Pleroma.Upload.Filter.Exiftool as an alternate EXIF stripping mechanism targeting GPS/location metadata.
81 - "By approval" registrations mode.
82 - Configuration: Added `:welcome` settings for the welcome message to newly registered users. You can send a welcome message as a direct message, chat or email.
83 - Ability to hide favourites and emoji reactions in the API with `[:instance, :show_reactions]` config.
86 <summary>API Changes</summary>
88 - Mastodon API: Add pleroma.parent_visible field to statuses.
89 - Mastodon API: Extended `/api/v1/instance`.
90 - Mastodon API: Support for `include_types` in `/api/v1/notifications`.
91 - Mastodon API: Added `/api/v1/notifications/:id/dismiss` endpoint.
92 - Mastodon API: Add support for filtering replies in public and home timelines.
93 - Mastodon API: Support for `bot` field in `/api/v1/accounts/update_credentials`.
94 - Mastodon API: Support irreversible property for filters.
95 - Mastodon API: Add pleroma.favicon field to accounts.
96 - Admin API: endpoints for create/update/delete OAuth Apps.
97 - Admin API: endpoint for status view.
98 - OTP: Add command to reload emoji packs
102 - Fix list pagination and other list issues.
103 - Support pagination in conversations API
104 - **Breaking**: SimplePolicy `:reject` and `:accept` allow deletions again
105 - Fix follower/blocks import when nicknames starts with @
106 - Filtering of push notifications on activities from blocked domains
107 - Resolving Peertube accounts with Webfinger
108 - `blob:` urls not being allowed by connect-src CSP
109 - Mastodon API: fix `GET /api/v1/notifications` not returning the full result set
110 - Rich Media Previews for Twitter links
111 - Admin API: fix `GET /api/pleroma/admin/users/:nickname/credentials` returning 404 when getting the credentials of a remote user while `:instance, :limit_to_local_content` is set to `:unauthenticated`
112 - Fix CSP policy generation to include remote Captcha services
113 - Fix edge case where MediaProxy truncates media, usually caused when Caddy is serving content for the other Federated instance.
114 - Emoji Packs could not be listed when instance was set to `public: false`
115 - Fix whole_word always returning false on filter get requests
116 - Migrations not working on OTP releases if the database was connected over ssl
117 - Fix relay following
119 ## [2.0.7] - 2020-06-13
122 - Fix potential DoSes exploiting atom leaks in rich media parser and the `UserAllowListPolicy` MRF policy
125 - CSP: not allowing images/media from every host when mediaproxy is disabled
126 - CSP: not adding mediaproxy base url to image/media hosts
127 - StaticFE missing the CSS file
133 ## [2.0.6] - 2020-06-09
136 - CSP: harden `image-src` and `media-src` when MediaProxy is used
139 - AP C2S: Fix pagination in inbox/outbox
140 - Various compilation errors on OTP 23
141 - Mastodon API streaming: Repeats from muted threads not being filtered
144 - Various database performance improvements
147 1. Run database migrations (inside Pleroma directory):
148 - OTP: `./bin/pleroma_ctl migrate`
149 - From Source: `mix ecto.migrate`
152 ## [2.0.5] - 2020-05-13
155 - Fix possible private status leaks in Mastodon Streaming API
158 - Crashes when trying to block a user if block federation is disabled
159 - Not being able to start the instance without `erlang-eldap` installed
160 - Users with bios over the limit getting rejected
161 - Follower counters not being updated on incoming follow accepts
167 ## [2.0.4] - 2020-05-10
170 - AP C2S: Fix a potential DoS by creating nonsensical objects that break timelines
173 - Peertube user lookups not working
174 - `InsertSkeletonsForDeletedUsers` migration failing on some instances
175 - Healthcheck reporting the number of memory currently used, rather than allocated in total
176 - LDAP not being usable in OTP releases
177 - Default apache configuration having tls chain issues
183 1. Remove the following line from your config:
185 SSLCertificateFile /etc/letsencrypt/live/${servername}/cert.pem
192 ## [2.0.3] - 2020-05-02
195 - Disallow re-registration of previously deleted users, which allowed viewing direct messages addressed to them
196 - Mastodon API: Fix `POST /api/v1/follow_requests/:id/authorize` allowing to force a follow from a local user even if they didn't request to follow
197 - CSP: Sandbox uploads
200 - Notifications from blocked domains
201 - Potential federation issues with Mastodon versions before 3.0.0
202 - HTTP Basic Authentication permissions issue
203 - Follow/Block imports not being able to find the user if the nickname started with an `@`
204 - Instance stats counting internal users
205 - Inability to run a From Source release without git
206 - ObjectAgePolicy didn't filter out old messages
207 - `blob:` urls not being allowed by CSP
210 - NodeInfo: ObjectAgePolicy settings to the `federation` list.
211 - Follow request notifications
213 <summary>API Changes</summary>
214 - Admin API: `GET /api/pleroma/admin/need_reboot`.
220 2. Run database migrations (inside Pleroma directory):
221 - OTP: `./bin/pleroma_ctl migrate`
222 - From Source: `mix ecto.migrate`
223 3. Reset status visibility counters (inside Pleroma directory):
224 - OTP: `./bin/pleroma_ctl refresh_counter_cache`
225 - From Source: `mix pleroma.refresh_counter_cache`
228 ## [2.0.2] - 2020-04-08
230 - Support for Funkwhale's `Audio` activity
231 - Admin API: `PATCH /api/pleroma/admin/users/:nickname/update_credentials`
234 - Blocked/muted users still generating push notifications
235 - Input textbox for bio ignoring newlines
236 - OTP: Inability to use PostgreSQL databases with SSL
237 - `user delete_activities` breaking when trying to delete already deleted posts
238 - Incorrect URL for Funkwhale channels
243 ## [2.0.1] - 2020-03-15
245 - Static-FE: Fix remote posts not being sanitized
249 - Rate limiter crashes when there is no explicitly specified ip in the config
250 - 500 errors when no `Accept` header is present if Static-FE is enabled
251 - Instance panel not being updated immediately due to wrong `Cache-Control` headers
252 - Statuses posted with BBCode/Markdown having unncessary newlines in Pleroma-FE
253 - OTP: Fix some settings not being migrated to in-database config properly
254 - No `Cache-Control` headers on attachment/media proxy requests
255 - Character limit enforcement being off by 1
256 - Mastodon Streaming API: hashtag timelines not working
259 - BBCode and Markdown formatters will no longer return any `\n` and only use `<br/>` for newlines
260 - Mastodon API: Allow registration without email if email verification is not enabled
264 1. Remove `proxy_ignore_headers Cache-Control;` and `proxy_hide_header Cache-Control;` from your config.
267 1. Run database migrations (inside Pleroma directory):
268 - OTP: `./bin/pleroma_ctl migrate`
269 - From Source: `mix ecto.migrate`
272 ## [2.0.0] - 2019-03-08
274 - Mastodon API: Fix being able to request enormous amount of statuses in timelines leading to DoS. Now limited to 40 per request.
277 - **Breaking**: Removed 1.0+ deprecated configurations `Pleroma.Upload, :strip_exif` and `:instance, :dedupe_media`
278 - **Breaking**: OStatus protocol support
279 - **Breaking**: MDII uploader
280 - **Breaking**: Using third party engines for user recommendation
282 <summary>API Changes</summary>
284 - **Breaking**: AdminAPI: migrate_from_db endpoint
288 - **Breaking:** Pleroma won't start if it detects unapplied migrations
289 - **Breaking:** Elixir >=1.8 is now required (was >= 1.7)
290 - **Breaking:** `Pleroma.Plugs.RemoteIp` and `:rate_limiter` enabled by default. Please ensure your reverse proxy forwards the real IP!
291 - **Breaking:** attachment links (`config :pleroma, :instance, no_attachment_links` and `config :pleroma, Pleroma.Upload, link_name`) disabled by default
292 - **Breaking:** OAuth: defaulted `[:auth, :enforce_oauth_admin_scope_usage]` setting to `true` which demands `admin` OAuth scope to perform admin actions (in addition to `is_admin` flag on User); make sure to use bundled or newer versions of AdminFE & PleromaFE to access admin / moderator features.
293 - **Breaking:** Dynamic configuration has been rearchitected. The `:pleroma, :instance, dynamic_configuration` setting has been replaced with `config :pleroma, configurable_from_database`. Please backup your configuration to a file and run the migration task to ensure consistency with the new schema.
294 - **Breaking:** `:instance, no_attachment_links` has been replaced with `:instance, attachment_links` which still takes a boolean value but doesn't use double negative language.
295 - Replaced [pleroma_job_queue](https://git.pleroma.social/pleroma/pleroma_job_queue) and `Pleroma.Web.Federator.RetryQueue` with [Oban](https://github.com/sorentwo/oban) (see [`docs/config.md`](docs/config.md) on migrating customized worker / retry settings)
296 - Introduced [quantum](https://github.com/quantum-elixir/quantum-core) job scheduler
297 - Enabled `:instance, extended_nickname_format` in the default config
298 - Add `rel="ugc"` to all links in statuses, to prevent SEO spam
299 - Extract RSS functionality from OStatus
300 - MRF (Simple Policy): Also use `:accept`/`:reject` on the actors rather than only their activities
301 - OStatus: Extract RSS functionality
302 - Deprecated `User.Info` embedded schema (fields moved to `User`)
303 - Store status data inside Flag activity
304 - Deprecated (reorganized as `UserRelationship` entity) User fields with user AP IDs (`blocks`, `mutes`, `muted_reblogs`, `muted_notifications`, `subscribers`).
305 - Rate limiter is now disabled for localhost/socket (unless remoteip plug is enabled)
306 - Logger: default log level changed from `warn` to `info`.
307 - Config mix task `migrate_to_db` truncates `config` table before migrating the config file.
308 - Allow account registration without an email
309 - Default to `prepare: :unnamed` in the database configuration.
310 - Instance stats are now loaded on startup instead of being empty until next hourly job.
312 <summary>API Changes</summary>
314 - **Breaking** EmojiReactions: Change endpoints and responses to align with Mastodon
315 - **Breaking** Admin API: `PATCH /api/pleroma/admin/users/:nickname/force_password_reset` is now `PATCH /api/pleroma/admin/users/force_password_reset` (accepts `nicknames` array in the request body)
316 - **Breaking:** Admin API: Return link alongside with token on password reset
317 - **Breaking:** Admin API: `PUT /api/pleroma/admin/reports/:id` is now `PATCH /api/pleroma/admin/reports`, see admin_api.md for details
318 - **Breaking:** `/api/pleroma/admin/users/invite_token` now uses `POST`, changed accepted params and returns full invite in json instead of only token string.
319 - **Breaking** replying to reports is now "report notes", endpoint changed from `POST /api/pleroma/admin/reports/:id/respond` to `POST /api/pleroma/admin/reports/:id/notes`
320 - Mastodon API: stopped sanitizing display names, field names and subject fields since they are supposed to be treated as plaintext
321 - Admin API: Return `total` when querying for reports
322 - Mastodon API: Return `pleroma.direct_conversation_id` when creating a direct message (`POST /api/v1/statuses`)
323 - Admin API: Return link alongside with token on password reset
324 - Admin API: Support authentication via `x-admin-token` HTTP header
325 - Mastodon API: Add `pleroma.direct_conversation_id` to the status endpoint (`GET /api/v1/statuses/:id`)
326 - Mastodon API: `pleroma.thread_muted` to the Status entity
327 - Mastodon API: Mark the direct conversation as read for the author when they send a new direct message
328 - Mastodon API, streaming: Add `pleroma.direct_conversation_id` to the `conversation` stream event payload.
329 - Admin API: Render whole status in grouped reports
330 - Mastodon API: User timelines will now respect blocks, unless you are getting the user timeline of somebody you blocked (which would be empty otherwise).
331 - Mastodon API: Favoriting / Repeating a post multiple times will now return the identical response every time. Before, executing that action twice would return an error ("already favorited") on the second try.
332 - Mastodon API: Limit timeline requests to 3 per timeline per 500ms per user/ip by default.
333 - Admin API: `PATCH /api/pleroma/admin/users/:nickname/credentials` and `GET /api/pleroma/admin/users/:nickname/credentials`
337 - `:chat_limit` option to limit chat characters.
338 - `cleanup_attachments` option to remove attachments along with statuses. Does not affect duplicate files and attachments without status. Enabling this will increase load to database when deleting statuses on larger instances.
339 - Refreshing poll results for remote polls
340 - Authentication: Added rate limit for password-authorized actions / login existence checks
341 - Static Frontend: Add the ability to render user profiles and notices server-side without requiring JS app.
342 - Mix task to re-count statuses for all users (`mix pleroma.count_statuses`)
343 - Mix task to list all users (`mix pleroma.user list`)
344 - Mix task to send a test email (`mix pleroma.email test`)
345 - Support for `X-Forwarded-For` and similar HTTP headers which used by reverse proxies to pass a real user IP address to the backend. Must not be enabled unless your instance is behind at least one reverse proxy (such as Nginx, Apache HTTPD or Varnish Cache).
346 - MRF: New module which handles incoming posts based on their age. By default, all incoming posts that are older than 2 days will be unlisted and not shown to their followers.
347 - User notification settings: Add `privacy_option` option.
348 - Support for custom Elixir modules (such as MRF policies)
349 - User settings: Add _This account is a_ option.
350 - A new users admin digest email
351 - OAuth: admin scopes support (relevant setting: `[:auth, :enforce_oauth_admin_scope_usage]`).
352 - Add an option `authorized_fetch_mode` to require HTTP signatures for AP fetches.
353 - ActivityPub: support for `replies` collection (output for outgoing federation & fetching on incoming federation).
354 - Mix task to refresh counter cache (`mix pleroma.refresh_counter_cache`)
356 <summary>API Changes</summary>
358 - Job queue stats to the healthcheck page
359 - Admin API: Add ability to fetch reports, grouped by status `GET /api/pleroma/admin/grouped_reports`
360 - Admin API: Add ability to require password reset
361 - Mastodon API: Account entities now include `follow_requests_count` (planned Mastodon 3.x addition)
362 - Pleroma API: `GET /api/v1/pleroma/accounts/:id/scrobbles` to get a list of recently scrobbled items
363 - Pleroma API: `POST /api/v1/pleroma/scrobble` to scrobble a media item
364 - Mastodon API: Add `upload_limit`, `avatar_upload_limit`, `background_upload_limit`, and `banner_upload_limit` to `/api/v1/instance`
365 - Mastodon API: Add `pleroma.unread_conversation_count` to the Account entity
366 - OAuth: support for hierarchical permissions / [Mastodon 2.4.3 OAuth permissions](https://docs.joinmastodon.org/api/permissions/)
367 - Metadata Link: Atom syndication Feed
368 - Mix task to re-count statuses for all users (`mix pleroma.count_statuses`)
369 - Mastodon API: Add `exclude_visibilities` parameter to the timeline and notification endpoints
370 - Admin API: `/users/:nickname/toggle_activation` endpoint is now deprecated in favor of: `/users/activate`, `/users/deactivate`, both accept `nicknames` array
371 - Admin API: Multiple endpoints now require `nicknames` array, instead of singe `nickname`:
372 - `POST/DELETE /api/pleroma/admin/users/:nickname/permission_group/:permission_group` are deprecated in favor of: `POST/DELETE /api/pleroma/admin/users/permission_group/:permission_group`
373 - `DELETE /api/pleroma/admin/users` (`nickname` query param or `nickname` sent in JSON body) is deprecated in favor of: `DELETE /api/pleroma/admin/users` (`nicknames` query array param or `nicknames` sent in JSON body)
374 - Admin API: Add `GET /api/pleroma/admin/relay` endpoint - lists all followed relays
375 - Pleroma API: `POST /api/v1/pleroma/conversations/read` to mark all conversations as read
376 - ActivityPub: Support `Move` activities
377 - Mastodon API: Add `/api/v1/markers` for managing timeline read markers
378 - Mastodon API: Add the `recipients` parameter to `GET /api/v1/conversations`
379 - Configuration: `feed` option for user atom feed.
380 - Pleroma API: Add Emoji reactions
381 - Admin API: Add `/api/pleroma/admin/instances/:instance/statuses` - lists all statuses from a given instance
382 - Admin API: Add `/api/pleroma/admin/users/:nickname/statuses` - lists all statuses from a given user
383 - Admin API: `PATCH /api/pleroma/users/confirm_email` to confirm email for multiple users, `PATCH /api/pleroma/users/resend_confirmation_email` to resend confirmation email for multiple users
384 - ActivityPub: Configurable `type` field of the actors.
385 - Mastodon API: `/api/v1/accounts/:id` has `source/pleroma/actor_type` field.
386 - Mastodon API: `/api/v1/update_credentials` accepts `actor_type` field.
387 - Captcha: Support native provider
388 - Captcha: Enable by default
389 - Mastodon API: Add support for `account_id` param to filter notifications by the account
390 - Mastodon API: Add `emoji_reactions` property to Statuses
391 - Mastodon API: Change emoji reaction reply format
392 - Notifications: Added `pleroma:emoji_reaction` notification type
393 - Mastodon API: Change emoji reaction reply format once more
394 - Configuration: `feed.logo` option for tag feed.
395 - Tag feed: `/tags/:tag.rss` - list public statuses by hashtag.
396 - Mastodon API: Add `reacted` property to `emoji_reactions`
397 - Pleroma API: Add reactions for a single emoji.
398 - ActivityPub: `[:activitypub, :note_replies_output_limit]` setting sets the number of note self-replies to output on outgoing federation.
399 - Admin API: `GET /api/pleroma/admin/stats` to get status count by visibility scope
400 - Admin API: `GET /api/pleroma/admin/statuses` - list all statuses (accepts `godmode` and `local_only`)
404 - Report emails now include functional links to profiles of remote user accounts
405 - Not being able to log in to some third-party apps when logged in to MastoFE
406 - MRF: `Delete` activities being exempt from MRF policies
407 - OTP releases: Not being able to configure OAuth expired token cleanup interval
408 - OTP releases: Not being able to configure HTML sanitization policy
409 - OTP releases: Not being able to change upload limit (again)
410 - Favorites timeline now ordered by favorite date instead of post date
411 - Support for cancellation of a follow request
413 <summary>API Changes</summary>
415 - Mastodon API: Fix private and direct statuses not being filtered out from the public timeline for an authenticated user (`GET /api/v1/timelines/public`)
416 - Mastodon API: Inability to get some local users by nickname in `/api/v1/accounts/:id_or_nickname`
417 - AdminAPI: If some status received reports both in the "new" format and "old" format it was considered reports on two different statuses (in the context of grouped reports)
418 - Admin API: Error when trying to update reports in the "old" format
419 - Mastodon API: Marking a conversation as read (`POST /api/v1/conversations/:id/read`) now no longer brings it to the top in the user's direct conversation list
422 ## [1.1.9] - 2020-02-10
424 - OTP: Inability to set the upload limit (again)
425 - Not being able to pin polls
426 - Streaming API: incorrect handling of reblog mutes
427 - Rejecting the user when field length limit is exceeded
428 - OpenGraph provider: html entities in descriptions
430 ## [1.1.8] - 2020-01-10
432 - Captcha generation issues
433 - Returned Kocaptcha endpoint to configuration
434 - Captcha validity is now 5 minutes
436 ## [1.1.7] - 2019-12-13
438 - OTP: Inability to set the upload limit
439 - OTP: Inability to override node name/distribution type to run 2 Pleroma instances on the same machine
442 - Integrated captcha provider
445 - Captcha enabled by default
446 - Default Captcha provider changed from `Pleroma.Captcha.Kocaptcha` to `Pleroma.Captcha.Native`
447 - Better `Cache-Control` header for static content
449 ### Bundled Pleroma-FE Changes
451 - Icons in the navigation panel
454 - Improved support unauthenticated view of private instances
457 - Whitespace hack on empty post content
459 ## [1.1.6] - 2019-11-19
461 - Not being able to log into to third party apps when the browser is logged into mastofe
462 - Email confirmation not being required even when enabled
463 - Mastodon API: conversations API crashing when one status is malformed
465 ### Bundled Pleroma-FE Changes
471 - Image modal not closing unless clicked outside of image
472 - Attachment upload spinner not being centered
473 - Showing follow counters being 0 when they are actually hidden
475 ## [1.1.5] - 2019-11-09
477 - Polls having different numbers in timelines/notifications/poll api endpoints due to cache desyncronization
478 - Pleroma API: OAuth token endpoint not being found when ".json" suffix is appended
481 - Frontend bundle updated to [044c9ad0](https://git.pleroma.social/pleroma/pleroma-fe/commit/044c9ad0562af059dd961d50961a3880fca9c642)
483 ## [1.1.4] - 2019-11-01
485 - Added a migration that fills up empty user.info fields to prevent breakage after previous unsafe migrations.
486 - Failure to migrate from pre-1.0.0 versions
487 - Mastodon API: Notification stream not including follow notifications
489 ## [1.1.3] - 2019-10-25
491 - Blocked users showing up in notifications collapsed as if they were muted
492 - `pleroma_ctl` not working on Debian's default shell
494 ## [1.1.2] - 2019-10-18
496 - `pleroma_ctl` trying to connect to a running instance when generating the config, which of course doesn't exist.
498 ## [1.1.1] - 2019-10-18
500 - One of the migrations between 1.0.0 and 1.1.0 wiping user info of the relay user because of unexpected behavior of postgresql's `jsonb_set`, resulting in inability to post in the default configuration. If you were affected, please run the following query in postgres console, the relay user will be recreated automatically:
502 delete from users where ap_id = 'https://your.instance.hostname/relay';
504 - Bad user search matches
506 ## [1.1.0] - 2019-10-14
507 **Breaking:** The stable branch has been changed from `master` to `stable`. If you want to keep using 1.0, the `release/1.0` branch will receive security updates for 6 months after 1.1 release.
509 **OTP Note:** `pleroma_ctl` in 1.0 defaults to `master` and doesn't support specifying arbitrary branches, making `./pleroma_ctl update` fail. To fix this, fetch a version of `pleroma_ctl` from 1.1 using the command below and proceed with the update normally:
511 curl -Lo ./bin/pleroma_ctl 'https://git.pleroma.social/pleroma/pleroma/raw/develop/rel/files/bin/pleroma_ctl'
514 - Mastodon API: respect post privacy in `/api/v1/statuses/:id/{favourited,reblogged}_by`
517 - **Breaking:** GNU Social API with Qvitter extensions support
518 - Emoji: Remove longfox emojis.
519 - Remove `Reply-To` header from report emails for admins.
520 - ActivityPub: The `/objects/:uuid/likes` endpoint.
523 - **Breaking:** Configuration: A setting to explicitly disable the mailer was added, defaulting to true, if you are using a mailer add `config :pleroma, Pleroma.Emails.Mailer, enabled: true` to your config
524 - **Breaking:** Configuration: `/media/` is now removed when `base_url` is configured, append `/media/` to your `base_url` config to keep the old behaviour if desired
525 - **Breaking:** `/api/pleroma/notifications/read` is moved to `/api/v1/pleroma/notifications/read` and now supports `max_id` and responds with Mastodon API entities.
526 - Configuration: added `config/description.exs`, from which `docs/config.md` is generated
527 - Configuration: OpenGraph and TwitterCard providers enabled by default
528 - Configuration: Filter.AnonymizeFilename added ability to retain file extension with custom text
529 - Federation: Return 403 errors when trying to request pages from a user's follower/following collections if they have `hide_followers`/`hide_follows` set
530 - NodeInfo: Return `skipThreadContainment` in `metadata` for the `skip_thread_containment` option
531 - NodeInfo: Return `mailerEnabled` in `metadata`
532 - Mastodon API: Unsubscribe followers when they unfollow a user
533 - Mastodon API: `pleroma.thread_muted` key in the Status entity
534 - AdminAPI: Add "godmode" while fetching user statuses (i.e. admin can see private statuses)
535 - Improve digest email template
536 – Pagination: (optional) return `total` alongside with `items` when paginating
537 - The `Pleroma.FlakeId` module has been replaced with the `flake_id` library.
540 - Following from Osada
541 - Favorites timeline doing database-intensive queries
542 - Metadata rendering errors resulting in the entire page being inaccessible
543 - `federation_incoming_replies_max_depth` option being ignored in certain cases
544 - Mastodon API: Handling of search timeouts (`/api/v1/search` and `/api/v2/search`)
545 - Mastodon API: Misskey's endless polls being unable to render
546 - Mastodon API: Embedded relationships not being properly rendered in the Account entity of Status entity
547 - Mastodon API: Notifications endpoint crashing if one notification failed to render
548 - Mastodon API: `exclude_replies` is correctly handled again.
549 - Mastodon API: Add `account_id`, `type`, `offset`, and `limit` to search API (`/api/v1/search` and `/api/v2/search`)
550 - Mastodon API, streaming: Fix filtering of notifications based on blocks/mutes/thread mutes
551 - Mastodon API: Fix private and direct statuses not being filtered out from the public timeline for an authenticated user (`GET /api/v1/timelines/public`)
552 - Mastodon API: Ensure the `account` field is not empty when rendering Notification entities.
553 - Mastodon API: Inability to get some local users by nickname in `/api/v1/accounts/:id_or_nickname`
554 - Mastodon API: Blocks are now treated consistently between the Streaming API and the Timeline APIs
555 - Rich Media: Parser failing when no TTL can be found by image TTL setters
556 - Rich Media: The crawled URL is now spliced into the rich media data.
557 - ActivityPub S2S: sharedInbox usage has been mostly aligned with the rules in the AP specification.
558 - ActivityPub C2S: follower/following collection pages being inaccessible even when authentifucated if `hide_followers`/ `hide_follows` was set
559 - ActivityPub: Deactivated user deletion
560 - ActivityPub: Fix `/users/:nickname/inbox` crashing without an authenticated user
561 - MRF: fix ability to follow a relay when AntiFollowbotPolicy was enabled
562 - ActivityPub: Correct addressing of Undo.
563 - ActivityPub: Correct addressing of profile update activities.
564 - ActivityPub: Polls are now refreshed when necessary.
565 - Report emails now include functional links to profiles of remote user accounts
566 - Existing user id not being preserved on insert conflict
567 - Pleroma.Upload base_url was not automatically whitelisted by MediaProxy. Now your custom CDN or file hosting will be accessed directly as expected.
568 - Report email not being sent to admins when the reporter is a remote user
569 - Reverse Proxy limiting `max_body_length` was incorrectly defined and only checked `Content-Length` headers which may not be sufficient in some circumstances
572 - Expiring/ephemeral activites. All activities can have expires_at value set, which controls when they should be deleted automatically.
573 - Mastodon API: in post_status, the expires_in parameter lets you set the number of seconds until an activity expires. It must be at least one hour.
574 - Mastodon API: all status JSON responses contain a `pleroma.expires_at` item which states when an activity will expire. The value is only shown to the user who created the activity. To everyone else it's empty.
575 - Configuration: `ActivityExpiration.enabled` controls whether expired activites will get deleted at the appropriate time. Enabled by default.
576 - Conversations: Add Pleroma-specific conversation endpoints and status posting extensions. Run the `bump_all_conversations` task again to create the necessary data.
577 - MRF: Support for priming the mediaproxy cache (`Pleroma.Web.ActivityPub.MRF.MediaProxyWarmingPolicy`)
578 - MRF: Support for excluding specific domains from Transparency.
579 - MRF: Support for filtering posts based on who they mention (`Pleroma.Web.ActivityPub.MRF.MentionPolicy`)
580 - Mastodon API: Support for the [`tagged` filter](https://github.com/tootsuite/mastodon/pull/9755) in [`GET /api/v1/accounts/:id/statuses`](https://docs.joinmastodon.org/api/rest/accounts/#get-api-v1-accounts-id-statuses)
581 - Mastodon API, streaming: Add support for passing the token in the `Sec-WebSocket-Protocol` header
582 - Mastodon API, extension: Ability to reset avatar, profile banner, and background
583 - Mastodon API: Add support for `fields_attributes` API parameter (setting custom fields)
584 - Mastodon API: Add support for categories for custom emojis by reusing the group feature. <https://github.com/tootsuite/mastodon/pull/11196>
585 - Mastodon API: Add support for muting/unmuting notifications
586 - Mastodon API: Add support for the `blocked_by` attribute in the relationship API (`GET /api/v1/accounts/relationships`). <https://github.com/tootsuite/mastodon/pull/10373>
587 - Mastodon API: Add support for the `domain_blocking` attribute in the relationship API (`GET /api/v1/accounts/relationships`).
588 - Mastodon API: Add `pleroma.deactivated` to the Account entity
589 - Mastodon API: added `/auth/password` endpoint for password reset with rate limit.
590 - Mastodon API: /api/v1/accounts/:id/statuses now supports nicknames or user id
591 - Mastodon API: Improve support for the user profile custom fields
592 - Mastodon API: Add support for `fields_attributes` API parameter (setting custom fields)
593 - Mastodon API: Added an endpoint to get multiple statuses by IDs (`GET /api/v1/statuses/?ids[]=1&ids[]=2`)
594 - Admin API: Return users' tags when querying reports
595 - Admin API: Return avatar and display name when querying users
596 - Admin API: Allow querying user by ID
597 - Admin API: Added support for `tuples`.
598 - Admin API: Added endpoints to run mix tasks pleroma.config migrate_to_db & pleroma.config migrate_from_db
599 - Added synchronization of following/followers counters for external users
600 - Configuration: `enabled` option for `Pleroma.Emails.Mailer`, defaulting to `false`.
601 - Configuration: Pleroma.Plugs.RateLimiter `bucket_name`, `params` options.
602 - Configuration: `user_bio_length` and `user_name_length` options.
604 - Twitter API: added rate limit for `/api/account/password_reset` endpoint.
605 - ActivityPub: Add an internal service actor for fetching ActivityPub objects.
606 - ActivityPub: Optional signing of ActivityPub object fetches.
607 - Admin API: Endpoint for fetching latest user's statuses
608 - Pleroma API: Add `/api/v1/pleroma/accounts/confirmation_resend?email=<email>` for resending account confirmation.
609 - Pleroma API: Email change endpoint.
610 - Admin API: Added moderation log
611 - Web response cache (currently, enabled for ActivityPub)
612 - Reverse Proxy: Do not retry failed requests to limit pressure on the peer
615 - Configuration: Filter.AnonymizeFilename added ability to retain file extension with custom text
616 - Admin API: changed json structure for saving config settings.
617 - RichMedia: parsers and their order are configured in `rich_media` config.
618 - RichMedia: add the rich media ttl based on image expiration time.
620 ## [1.0.7] - 2019-09-26
622 - Broken federation on Erlang 22 (previous versions of hackney http client were using an option that got deprecated)
624 - ActivityPub: The first page in inboxes/outboxes is no longer embedded.
626 ## [1.0.6] - 2019-08-14
628 - MRF: fix use of unserializable keyword lists in describe() implementations
629 - ActivityPub S2S: POST requests are now signed with `(request-target)` pseudo-header.
631 ## [1.0.5] - 2019-08-13
633 - Mastodon API: follower/following counters not being nullified, when `hide_follows`/`hide_followers` is set
634 - Mastodon API: `muted` in the Status entity, using author's account to determine if the thread was muted
635 - Mastodon API: return the actual profile URL in the Account entity's `url` property when appropriate
636 - Templates: properly style anchor tags
637 - Objects being re-embedded to activities after being updated (e.g faved/reposted). Running 'mix pleroma.database prune_objects' again is advised.
638 - Not being able to access the Mastodon FE login page on private instances
639 - MRF: ensure that subdomain_match calls are case-insensitive
640 - Fix internal server error when using the healthcheck API.
643 - **Breaking:** MRF describe API, which adds support for exposing configuration information about MRF policies to NodeInfo.
644 Custom modules will need to be updated by adding, at the very least, `def describe, do: {:ok, %{}}` to the MRF policy modules.
645 - Relays: Added a task to list relay subscriptions.
646 - MRF: Support for filtering posts based on ActivityStreams vocabulary (`Pleroma.Web.ActivityPub.MRF.VocabularyPolicy`)
647 - MRF (Simple Policy): Support for wildcard domains.
648 - Support for wildcard domains in user domain blocks setting.
649 - Configuration: `quarantined_instances` support wildcard domains.
650 - Mix Tasks: `mix pleroma.database fix_likes_collections`
651 - Configuration: `federation_incoming_replies_max_depth` option
654 - Federation: Remove `likes` from objects.
655 - **Breaking:** ActivityPub: The `accept_blocks` configuration setting.
657 ## [1.0.4] - 2019-08-01
659 - Invalid SemVer version generation, when the current branch does not have commits ahead of tag/checked out on a tag
661 ## [1.0.3] - 2019-07-31
663 - OStatus: eliminate the possibility of a protocol downgrade attack.
664 - OStatus: prevent following locked accounts, bypassing the approval process.
665 - TwitterAPI: use CommonAPI to handle remote follows instead of OStatus.
667 ## [1.0.2] - 2019-07-28
669 - Not being able to pin unlisted posts
670 - Mastodon API: represent poll IDs as strings
671 - MediaProxy: fix matching filenames
672 - MediaProxy: fix filename encoding
673 - Migrations: fix a sporadic migration failure
674 - Metadata rendering errors resulting in the entire page being inaccessible
675 - Federation/MediaProxy not working with instances that have wrong certificate order
676 - ActivityPub S2S: remote user deletions now work the same as local user deletions.
679 - Configuration: OpenGraph and TwitterCard providers enabled by default
680 - Configuration: Filter.AnonymizeFilename added ability to retain file extension with custom text
682 ## [1.0.1] - 2019-07-14
684 - OStatus: fix an object spoofing vulnerability.
686 ## [1.0.0] - 2019-06-29
688 - Mastodon API: Fix display names not being sanitized
689 - Rich media: Do not crawl private IP ranges
692 - Digest email for inactive users
693 - Add a generic settings store for frontends / clients to use.
694 - Explicit addressing option for posting.
695 - Optional SSH access mode. (Needs `erlang-ssh` package on some distributions).
696 - [MongooseIM](https://github.com/esl/MongooseIM) http authentication support.
697 - LDAP authentication
698 - External OAuth provider authentication
699 - Support for building a release using [`mix release`](https://hexdocs.pm/mix/master/Mix.Tasks.Release.html)
700 - A [job queue](https://git.pleroma.social/pleroma/pleroma_job_queue) for federation, emails, web push, etc.
701 - [Prometheus](https://prometheus.io/) metrics
702 - Support for Mastodon's remote interaction
703 - Mix Tasks: `mix pleroma.database bump_all_conversations`
704 - Mix Tasks: `mix pleroma.database remove_embedded_objects`
705 - Mix Tasks: `mix pleroma.database update_users_following_followers_counts`
706 - Mix Tasks: `mix pleroma.user toggle_confirmed`
707 - Mix Tasks: `mix pleroma.config migrate_to_db`
708 - Mix Tasks: `mix pleroma.config migrate_from_db`
709 - Federation: Support for `Question` and `Answer` objects
710 - Federation: Support for reports
711 - Configuration: `poll_limits` option
712 - Configuration: `pack_extensions` option
713 - Configuration: `safe_dm_mentions` option
714 - Configuration: `link_name` option
715 - Configuration: `fetch_initial_posts` option
716 - Configuration: `notify_email` option
717 - Configuration: Media proxy `whitelist` option
718 - Configuration: `report_uri` option
719 - Configuration: `email_notifications` option
720 - Configuration: `limit_to_local_content` option
721 - Pleroma API: User subscriptions
722 - Pleroma API: Healthcheck endpoint
723 - Pleroma API: `/api/v1/pleroma/mascot` per-user frontend mascot configuration endpoints
724 - Admin API: Endpoints for listing/revoking invite tokens
725 - Admin API: Endpoints for making users follow/unfollow each other
726 - Admin API: added filters (role, tags, email, name) for users endpoint
727 - Admin API: Endpoints for managing reports
728 - Admin API: Endpoints for deleting and changing the scope of individual reported statuses
729 - Admin API: Endpoints to view and change config settings.
730 - AdminFE: initial release with basic user management accessible at /pleroma/admin/
731 - Mastodon API: Add chat token to `verify_credentials` response
732 - Mastodon API: Add background image setting to `update_credentials`
733 - Mastodon API: [Scheduled statuses](https://docs.joinmastodon.org/api/rest/scheduled-statuses/)
734 - Mastodon API: `/api/v1/notifications/destroy_multiple` (glitch-soc extension)
735 - Mastodon API: `/api/v1/pleroma/accounts/:id/favourites` (API extension)
736 - Mastodon API: [Reports](https://docs.joinmastodon.org/api/rest/reports/)
737 - Mastodon API: `POST /api/v1/accounts` (account creation API)
738 - Mastodon API: [Polls](https://docs.joinmastodon.org/api/rest/polls/)
739 - ActivityPub C2S: OAuth endpoints
740 - Metadata: RelMe provider
741 - OAuth: added support for refresh tokens
742 - Emoji packs and emoji pack manager
743 - Object pruning (`mix pleroma.database prune_objects`)
744 - OAuth: added job to clean expired access tokens
745 - MRF: Support for rejecting reports from specific instances (`mrf_simple`)
746 - MRF: Support for stripping avatars and banner images from specific instances (`mrf_simple`)
747 - MRF: Support for running subchains.
748 - Configuration: `skip_thread_containment` option
749 - Configuration: `rate_limit` option. See `Pleroma.Plugs.RateLimiter` documentation for details.
750 - MRF: Support for filtering out likely spam messages by rejecting posts from new users that contain links.
751 - Configuration: `ignore_hosts` option
752 - Configuration: `ignore_tld` option
753 - Configuration: default syslog tag "Pleroma" is now lowercased to "pleroma"
756 - **Breaking:** bind to 127.0.0.1 instead of 0.0.0.0 by default
757 - **Breaking:** Configuration: move from Pleroma.Mailer to Pleroma.Emails.Mailer
758 - Thread containment / test for complete visibility will be skipped by default.
759 - Enforcement of OAuth scopes
760 - Add multiple use/time expiring invite token
761 - Restyled OAuth pages to fit with Pleroma's default theme
762 - Link/mention/hashtag detection is now handled by [auto_linker](https://git.pleroma.social/pleroma/auto_linker)
763 - NodeInfo: Return `safe_dm_mentions` feature flag
764 - Federation: Expand the audience of delete activities to all recipients of the deleted object
765 - Federation: Removed `inReplyToStatusId` from objects
766 - Configuration: Dedupe enabled by default
767 - Configuration: Default log level in `prod` environment is now set to `warn`
768 - Configuration: Added `extra_cookie_attrs` for setting non-standard cookie attributes. Defaults to ["SameSite=Lax"] so that remote follows work.
769 - Timelines: Messages involving people you have blocked will be excluded from the timeline in all cases instead of just repeats.
770 - Admin API: Move the user related API to `api/pleroma/admin/users`
771 - Admin API: `POST /api/pleroma/admin/users` will take list of users
772 - Pleroma API: Support for emoji tags in `/api/pleroma/emoji` resulting in a breaking API change
773 - Mastodon API: Support for `exclude_types`, `limit` and `min_id` in `/api/v1/notifications`
774 - Mastodon API: Add `languages` and `registrations` to `/api/v1/instance`
775 - Mastodon API: Provide plaintext versions of cw/content in the Status entity
776 - Mastodon API: Add `pleroma.conversation_id`, `pleroma.in_reply_to_account_acct` fields to the Status entity
777 - Mastodon API: Add `pleroma.tags`, `pleroma.relationship{}`, `pleroma.is_moderator`, `pleroma.is_admin`, `pleroma.confirmation_pending`, `pleroma.hide_followers`, `pleroma.hide_follows`, `pleroma.hide_favorites` fields to the User entity
778 - Mastodon API: Add `pleroma.show_role`, `pleroma.no_rich_text` fields to the Source subentity
779 - Mastodon API: Add support for updating `no_rich_text`, `hide_followers`, `hide_follows`, `hide_favorites`, `show_role` in `PATCH /api/v1/update_credentials`
780 - Mastodon API: Add `pleroma.is_seen` to the Notification entity
781 - Mastodon API: Add `pleroma.local` to the Status entity
782 - Mastodon API: Add `preview` parameter to `POST /api/v1/statuses`
783 - Mastodon API: Add `with_muted` parameter to timeline endpoints
784 - Mastodon API: Actual reblog hiding instead of a dummy
785 - Mastodon API: Remove attachment limit in the Status entity
786 - Mastodon API: Added support max_id & since_id for bookmark timeline endpoints.
787 - Deps: Updated Cowboy to 2.6
788 - Deps: Updated Ecto to 3.0.7
789 - Don't ship finmoji by default, they can be installed as an emoji pack
790 - Hide deactivated users and their statuses
791 - Posts which are marked sensitive or tagged nsfw no longer have link previews.
792 - HTTP connection timeout is now set to 10 seconds.
793 - Respond with a 404 Not implemented JSON error message when requested API is not implemented
794 - Rich Media: crawl only https URLs.
797 - Follow requests don't get 'stuck' anymore.
798 - Added an FTS index on objects. Running `vacuum analyze` and setting a larger `work_mem` is recommended.
799 - Followers counter not being updated when a follower is blocked
800 - Deactivated users being able to request an access token
801 - Limit on request body in rich media/relme parsers being ignored resulting in a possible memory leak
802 - Proper Twitter Card generation instead of a dummy
803 - Deletions failing for users with a large number of posts
804 - NodeInfo: Include admins in `staffAccounts`
805 - ActivityPub: Crashing when requesting empty local user's outbox
806 - Federation: Handling of objects without `summary` property
807 - Federation: Add a language tag to activities as required by ActivityStreams 2.0
808 - Federation: Do not federate avatar/banner if set to default allowing other servers/clients to use their defaults
809 - Federation: Cope with missing or explicitly nulled address lists
810 - Federation: Explicitly ensure activities addressed to `as:Public` become addressed to the followers collection
811 - Federation: Better cope with actors which do not declare a followers collection and use `as:Public` with these semantics
812 - Federation: Follow requests from remote users who have been blocked will be automatically rejected if appropriate
813 - MediaProxy: Parse name from content disposition headers even for non-whitelisted types
814 - MediaProxy: S3 link encoding
815 - Rich Media: Reject any data which cannot be explicitly encoded into JSON
816 - Pleroma API: Importing follows from Mastodon 2.8+
817 - Twitter API: Exposing default scope, `no_rich_text` of the user to anyone
818 - Twitter API: Returning the `role` object in user entity despite `show_role = false`
819 - Mastodon API: `/api/v1/favourites` serving only public activities
820 - Mastodon API: Reblogs having `in_reply_to_id` - `null` even when they are replies
821 - Mastodon API: Streaming API broadcasting wrong activity id
822 - Mastodon API: 500 errors when requesting a card for a private conversation
823 - Mastodon API: Handling of `reblogs` in `/api/v1/accounts/:id/follow`
824 - Mastodon API: Correct `reblogged`, `favourited`, and `bookmarked` values in the reblog status JSON
825 - Mastodon API: Exposing default scope of the user to anyone
826 - Mastodon API: Make `irreversible` field default to `false` [`POST /api/v1/filters`]
827 - Mastodon API: Replace missing non-nullable Card attributes with empty strings
828 - User-Agent is now sent correctly for all HTTP requests.
829 - MRF: Simple policy now properly delists imported or relayed statuses
832 - Configuration: `config :pleroma, :fe` in favor of the more flexible `config :pleroma, :frontend_configurations`
834 ## [0.9.99999] - 2019-05-31
836 - Mastodon API: Fix lists leaking private posts
838 ## [0.9.9999] - 2019-04-05
840 - Mastodon API: Fix content warnings skipping HTML sanitization
842 ## [0.9.999] - 2019-03-13
843 Frontend changes only.
845 - Added floating action button for posting status on mobile
847 - Changed user-settings icon to a pencil
849 - Keyboard shortcuts activating when typing a message
850 - Gaps when scrolling down on a timeline after showing new
852 ## [0.9.99] - 2019-03-08
854 - Update the frontend to the 0.9.99 tag
856 - Sign the date header in federation to fix Mastodon federation.
858 ## [0.9.9] - 2019-02-22
859 This is our first stable release.