1 This file documents some of the problems you may encounter when upgrading
2 your ports. We try our best to minimize these disruptions, but sometimes
5 You should get into the habit of checking this file for changes each time
6 you update your ports collection, before attempting any port upgrades.
9 AFFECTS: users of math/suitesparse who build it locally
10 AUTHOR: yuri@FreeBSD.org
12 The suitesparse needs to be uninstalled before math/suitesparse can be
13 correctly built. This is true for the version 5.2.0 and prior versions.
16 AFFECTS: users of www/gitea
17 AUTHOR: stb@lassitu.de
19 The www/gitea port no longer requires shell/bash. If you want to
20 stop using bash and deinstall the package, make sure to set the
21 configuration in etc/gitea/conf/app.ini, section [repository],
22 SCRIPT_TYPE to "sh". See app.ini.sample for an example.
25 AFFECTS: users of www/node
26 AUTHOR: bhughes@FreeBSD.org
28 The www/node port has been udpated to Node.js v10.0.0, the latest
29 upstream release. This is a major release, including many significant
30 changes. Users are encouraged to read the release announcements before
33 https://nodejs.org/en/blog/release/v10.0.0/
35 In particular, Node.js now depends on OpenSSL 1.1.0h, so the
36 BUNDLED_SSL option is enabled by default. Users can disable this
37 option when using security/openssl-devel as their default SSL library.
40 AFFECTS: users of news/nntp
41 AUTHOR: dinoex@FreeBSD.org
43 The option INETD was removed. If you used inetd, please change the path
44 in /etc/inetd.conf from /usr/local/sbin/nntpd to /usr/local/libexec/nntpd.
47 AFFECTS: users of security/libressl
48 AUTHOR: brnrd@FreeBSD.org
50 The port has been updated to the latest stable version 2.7 of LibreSSL.
51 The shared library versions of the libraries have been bumped.
53 After upgrading, manually update all packages that depend on any of the
54 libraries provided by LibreSSL (libssl, libcrypto and libtls) since the
55 versions of these libraries have changed. Normally, you can obtain the
56 list of dependent software by running the following command:
58 # pkg info -r libressl
60 Then you should rebuild all ports depending on libressl to avoid dangling
61 shared library dependencies. Poudriere and pkg handle this correctly,
62 portmaster and portupgrade users can use the following to rebuild all
66 portmaster -r libressl
68 portupgrade -fr security/libressl
71 AFFECTS: users of sysutils/zrepl
72 AUTHOR: woodsb02@FreeBSD.org
74 The zrepl update to 0.0.3 includes the following breaking changes:
75 - Snapshots are automatically bookmarked and pruning of bookmarks must
76 be configured by adding the keep_bookmarks parameter to the prune
77 policy section of the zrepl configuration file (source side only).
78 Be sure to understand the meaning bookmarks have for maximum
79 allowable replication downtime.
80 - The ssh+stdinserver transport protocol has changed, requiring zrepl
81 to be updates on both the sending and receiving side, and the daemon
82 restarted on both sides.
83 - The first outlet in the global.logging section of the configuration
84 file is now used for logging meta-errors (e.g. problems encountered
85 when writing to other logging outlets).
88 AFFECTS: users of databases/pecl-redis
89 AUTHOR: daniel@blodan.se
91 pecl-redis 4.0.0 breaks backwards compatibility, users
92 not aware if you are using the changed functionality or not
93 should swap to databases/pecl-redis3
96 AFFECTS: users of dns/dnscrypt-proxy2
97 AUTHOR: egypcio@googlemail.com
99 DNSCrypt-Proxy 2 has been updated to 2.0.10 and the configuration file
100 has changed from ${PREFIX}/etc/dnscrypt-proxy.toml to
101 ${PREFIX}/etc/dnscrypt-proxy/dnscrypt-proxy.toml.
104 AFFECTS: users of mail/postgrey
105 AUTHOR: ports.maintainer@evilphi.com
107 If you use any of the optional make.conf variables to specify the
108 postgrey user, group, db dir, or run dir when building the port, you will
109 need to change the prefix from PG_ to POSTGREY_*. The variables were
110 renamed to solve a namespace collision with the PostgreSQL ports.
113 AFFECTS: users of devel/php-composer
114 AUTHOT: madpilot@FreeBSD.org
116 Flavors have been added to the composer port with the update to
117 1.6.3. Due to the change in PKGNAME pkg(and other tols) will not
118 notice the update. It is required to tell pkg about the name
121 # pkg set -n php-composer:php56-composer
124 AFFECTS: users of KDE SC4
125 AUTHOR: kde@FreeBSD.org
127 Most of KDE Applications 17.12.3 have now landed in the ports tree.
128 There are still some missing pieces, that will follow soon.
130 As mentioned in the commit messages, users of KDE SC4 should stick with the
131 <foo>-kde4 named package.
133 As the MOVED entries for ports like databases/akonadi-kde4 have been removed
134 in the process of updating (as there now is again a databases/akonad), there
135 might be issues for people that update from a too old installed package list
138 These should be fixable by issuing a command à la
139 # pkg set --change-origin databases/akonadi:databases/akonadi-kde4 akonadi
142 AFFECTS: users of net-im/matterircd
143 AUTHOR: norrland@nullbyte.se
145 Matterircd has been updated to 0.17.0 and mattermost configuration settings
146 need to be migrated to [mattermost] section. See matterircd.toml.sample.
149 AFFECTS: users of www/nextcloud
150 AUTHOR: brnrd@FreeBSD.org
152 With the 13.0.1 update the path for Apps bundled with the package has
153 changed from "apps" to "apps-pkg". You must add an entry to the
154 "apps_paths" array in config/config.php of your nextcloud installation,
155 a patch for the default installation can be applied with:
157 # cd /usr/local/www/nextcloud
158 # su -m www -c "php ./occ config:import < /usr/local/share/nextcloud/fix-apps_paths.json"
161 AFFECTS: users of mail/dovecot and mail/dovecot-pigeonhole
162 AUTHOR: adamw@FreeBSD.org
164 Dovecot has been upgraded to 2.3.1, and pigeonhole to 0.5.1. Most
165 existing dovecot installations MUST be modified for 2.3, but for
166 most users the modifications are simple.
168 Modify your Dovecot conf.d/ files before spinning up 2.3.1. The
169 upgrading instructions are detailed here:
171 https://wiki2.dovecot.org/Upgrading/2.3
174 AFFECTS: users of lang/perl5*
175 AUTHOR: mat@FreeBSD.org
177 The default Perl version has been switched to Perl 5.26. If you are using
178 binary packages to upgrade your system, you do not have anything to do, pkg
179 upgrade will do the right thing. For the other people, follow the
180 instructions in entry 20161103, it should still be the same.
183 AFFECTS: users of net/samba48
184 AUTHOR: timur@FreeBSD.org
186 New Samba 4.8 upgrades the relevant database files in the way, that doesn't
187 allow easy fallback to the previous versions of Samba. So, before upgrading
188 to the new version make a backup of the /var/db/samba4/ directory.
190 Full list of changes, new features and upgrade procedure is available at:
192 https://www.samba.org/samba/history/samba-4.8.0.html
194 Please, read it carefully before upgrading!.
197 AFFECTS: users of x11/sterm
198 AUTHOR: pkubaj@anongoth.pl
200 The user-defined options in config.h have changed. You should
201 compare your config.h file with the default one and change
205 AFFECTS: users of dns/dnsmasq
206 AUTHOR: mandree@FreeBSD.org
208 Note that with dnsmasq 2.79, some parts of the interface have changed in an
209 incompatible way versus previous versions. This comprises changed recursion
210 behaviour, signature support, a change for SIGINT (vs. SIGHUP) behaviour.
212 Note especially that dnsmasq will no longer answer non-recursive queries
213 unless it is marked authoritative! Be sure to see the manual page for the
214 various --auth-* options, such as --auth-zone.
216 Please see the CHANGELOG that ships with dnsmasq for details.
219 AFFECTS: users of multimedia/plexpy
220 AUTHOR: feld@FreeBSD.org
222 Plexpy project has been renamed to Tautulli due to copyright
223 infringement. The software also has received a major update. Please
224 see the following upgrade instructions:
226 - Install multimedia/tautulli
227 - Create /var/db/tautulli, owned by the user you will run the daemon as
229 - Copy your config.ini and plexpy.db to /var/db/tautulli
230 - Enable the service and start the software
232 Tautulli should automatically find your database file, rename it to
233 tautulli.db, and perform the required updates.
236 AFFECTS: users of security/openssl
237 AUTHOR: brnrd@FreeBSD.org
239 The EXPCIPHERS option has been removed from the security/openssl port.
240 Use the security/openssl-unsafe port if you require this feature.
243 AFFECTS: users of net/unison
244 AUTHOR: madpilot@FreeBSD.org
246 Unison has been upgraded to version 2.51, which uses a different
247 wire protocol than 2.48 did. In order to support synchronization
248 with other computers where Unison is still at version 2.48, a new
249 port net/unison248 has been created. It provides unison248 and,
250 for the x11 flavor, also unison248-text. This unison248 port can
251 be installed in parallel with the existing net/unison port.
254 AFFECTS: */php* */pecl* */pear*
255 AUTHOR: mat@FreeBSD.org
257 PHP extensions and modules have been flavored.
259 People using Poudriere 3.2+ and binary packages do not have to do anything if
260 they are using PHP applications.
262 PHP modules and extensions may have change their names from php5- or php7- to
263 fully versionned phpXY-.
264 PECL extensions and PEAR modules package names have changed from pecl- and
265 pear- to phpXX-pecl and phpXX-pear-.
267 To rename an installed package to match the new naming scheme, for example,
268 for the imagick pecl extension, run:
270 # pkg set -n pecl-imagick:php56-pecl-imagick
272 For other people, to build the PHP 7.2 version of, for example,
273 databases/php-memcached, you need to run:
275 # make FLAVOR=php72 install
278 AFFECTS: users of www/nextcloud
279 AUTHOR: brnrd@FreeBSD.org
281 The file and directory permissions of Nextcloud have changed. Write
282 permissions have been removed from all directories except `data' and
283 `config'. For the updater to work, the app store of your installation
284 must be disabled. To disable the app-store prior to updating the
287 # cd /usr/local/www/nextcloud
288 # su -m www -c "php ./occ config:system:set appstoreenabled --value=false --type=boolean"
290 If you've already updated your nextcloud package, you must manually edit
291 the configuration of nextcloud (config/config.php) and add
293 'appstoreenabled' => false,
295 to the CONFIG array before the updater will run.
298 AFFECTS: users of lang/ruby23
299 AUTHOR: swills@FreeBSD.org
301 The default ruby version has been updated from 2.3 to 2.4.
303 If you compile your own ports you may keep 2.3 as the default version by
304 adding the following lines to your /etc/make.conf file:
307 # Keep ruby 2.3 as default version
309 DEFAULT_VERSIONS+=ruby=2.3
311 If you wish to update to the new default version, you need to first stop any
312 software that uses ruby. Then, you will need to follow these steps, depending
313 upon how you manage your system.
315 If you use pkgng, simply upgrade:
318 If you use portmaster, install new ruby, then rebuild all ports that depend
320 # portmaster -o lang/ruby24 lang/ruby23
321 # portmaster -R -r ruby-2.4
323 If you use portupgrade, install new ruby, then rebuild all ports that depend
326 # pkg delete -f ruby portupgrade
327 # make -C /usr/ports/ports-mgmt/portupgrade install clean
328 # pkg set -o lang/ruby23:lang/ruby24
329 # portupgrade -x ruby-2.4.\* -fr lang/ruby24
332 AFFECTS: users of japanese/lookup
333 AUTHOR: yasu@utahime.org
335 japanese/lookup is update to 1.99.96.20130920. This version is not
336 compatible with previous version 1.4.1 and incompatibility includes
337 how to setup. See info of Lookup for detail.
340 AFFECTS: users of net-mgmt/pmacct
341 AUTHOR: pi@FreeBSD.org
343 To allow separete pmacctd instances per interface, use
346 pmacctd_interfaces="re1 re2"
348 in /etc/rc.conf. The path to the config files will be
350 /usr/local/etc/pmacct/<interface>
353 AFFECTS: users of mail/mailman*
354 AUTHOR: mandree@FreeBSD.org
356 In order to overcome complaints about mismatched checksums in
357 Mailman/Default.py, mailman now configures the DEFAULT_EMAIL_HOST
358 and DEFAULT_URL_HOST to "localhost" statically, and the rc script
359 will check this and refuse to start on next boot.
361 Users must configure DEFAULT_EMAIL_HOST and DEFAULT_URL_HOST in
362 Mailman/mm_cfg.py properly and add this line below:
363 add_virtualhost(DEFAULT_URL_HOST, DEFAULT_EMAIL_HOST)
365 A short example has been added to:
366 ${PREFIX}/local/share/doc/mailman/FreeBSD-post-install-notes.
368 As of 2.1.26_3, the post-install script will add back the prior
369 default settings to mm_cfg.py (instead of Defaults.py) if no
370 virtual hosts have been defined, to cover the normal use cases
371 and initial installation.
374 AFFECTS: users of editors/emacs* and all ports using Emacs via USES=emacs
375 AUTHOR: jrm@FreeBSD.org
377 The Emacs ports framework has been updated to support flavors and the
378 editors/emacs-nox11 port has been replaced by the nox flavors of
379 editors/emacs and editors/emacs-devel.
382 --------------------------------------------------------
383 editors/emacs: full canna nox
384 editors/emacs-devel: full nox
385 ports using Emacs: full canna nox devel_full devel_nox
386 --------------------------------------------------------
388 For those using pre-built packages, if
392 does not install the new Emacs package, use one of
395 # pkg install emacs-canna
396 # pkg install emacs-nox
397 # pkg install emacs-devel
398 # pkg install emacs-devel_nox
400 For those building their own packages, a flavor other than the default must be
401 specified. For example, to build the nox flavor of editors/emacs, or to build
402 the devel_full flavor of a port using Emacs, use
404 # poudriere bulk -j 11amd64 editors/emacs@nox
405 # poudriere bulk -j 11amd64 print/pdf-tools@devel_full
409 # make FLAVOR=nox install
410 # make FLAVOR=devel_full
412 An alternative to the default flavor, full, for editors/emacs and
413 editors/emacs-devel can be set in make.conf. For example, to specify nox as
414 the default flavor for both ports, use
416 .if ${.CURDIR:M*/editors/emacs*}
420 For ports using Emacs, an alternative to the default flavor, full,
421 can be also be set in make.conf. For example, to automatically depend on
424 DEFAULT_VERSIONS+=emacs=nox
427 AFFECTS: users of x11-toolkits/kf5-kirigami2 and x11/kf5-plasma-framework
428 AUTHOR: kde@FreeBSD.org
430 Files that were previously installed by kf5-kirigami2 are now installed
431 by kf5-plasma-framework. This can lead to a conflict during the upgrade
433 It is recommended to first remove the package kf5-kirigami2.
436 AFFECTS: users of net-p2p/transmission-daemon
437 AUTHOR: woodsb02@FreeBSD.org
439 The transmission-daemon port has been updated to 2.92_4 to incorporate
440 a patch which mitigates DNS rebinding attacks. This will prevent
441 clients from being able to connect to the transmission daemon using
442 DNS with any hostname other than localhost, unless one of the
444 - Enable password authentication, then any hostname is allowed.
445 This can be achieved by either:
446 - setting rpc-authentication-required to true, and adding
447 credentials to the rpc-username and rpc-password fields in
448 settings.json (must be done whilst the transmission service is
450 - running transmission-daemon with the following arguments
451 (these can be set with transmission_flags in /etc/rc.conf):
452 -t -u USERNAME -v PASSWORD
454 - Add the allowed server hostnames to the rpc-host-whitelist setting
455 in settings.json (must be done whilst the transmission service is
456 stopped). Note that this value is NOT a list of allowed CLIENTS,
457 but instead a list of allowed SERVER hostnames.
460 AFFECTS: users of editors/vim-lite
461 AUTHOR: adamw@FreeBSD.org
463 The vim-lite port has been renamed to vim-console, because it isn't
464 actually any lighter. All three vim packages are built with
465 --enable-features=huge. Portmaster users will need to run this
468 portmaster -o editors/vim-console editors/vim-lite
470 If the switch doesn't happen automatically for you, just delete the
471 vim-lite package and install vim-console.
474 AFFECTS: users of www/qt5-webengine
475 AUTHOR: kde@FreeBSD.org
477 The upgrade of www/qt5-webengine to 5.9.3 may fail if an older version
478 of it is installed. It is recommended to either build the port in a
479 builder like poudriere, or to deinstall and then doing an install.
482 AFFECTS: users of security/gnupg and mail/mutt and mail/neomutt
483 AUTHOR: adamw@FreeBSD.org
485 The invocation for gpg from mutt/neomutt changed between gnupg-2.0
486 (which has expired and is now removed) and gnupg-2.2 (the current
487 version in the tree). Unless you're using gpgme, PGP-related
488 commands may fail in (neo)mutt.
490 In all cases, users are strongly urged to use security/gpgme to take
491 care of the setup for you. If you prefer to roll your own, the
492 following muttrc/neomuttrc entry has been reported to work:
494 pgp_decrypt_command="gpg2 %?p?--passphrase-fd 0 --pinentry-mode=loopback? --no-verbose --batch --output - %f"
496 See muttrc(5), neomuttrc(5), mutt.org, and neomutt.org for instructions
497 on (neo)mutt's gpg and gpgme instructions.
500 AFFECTS: users of devel/awscli
501 AUTHOR: bhughes@FreeBSD.org
503 The package name for devel/awscli has changed (back) to just awscli.
504 The introduction of flavors erroneously caused the awscli package to
505 be renamed to py27-awscli.
508 AFFECTS: users of net-im/ejabberd
509 AUTHOR: ashish@FreeBSD.org
511 If you are building ejabberd 17.11 on a host, which already has an older
512 version of ejabberd installed, then build process will fail with "unknown type
513 specifier" errors. As a workaround, please uninstall ejabberd before building
516 This has been reported upstream at:
517 https://github.com/processone/ejabberd/issues/2194
520 AFFECTS: users of dns/dnscrypt-proxy
521 AUTHOR: egypcio@googlemail.com
523 The 1.9.5_3 update of dns/dnscrypt-proxy replaces the default resolver used
524 by dnscrypt-proxy (cisco/OpenDNS) by a random one that does not log entries
528 AFFECTS: users of samba44
529 AUTHOR: antoine@FreeBSD.org
531 The default version of samba has been switched from 4.4 to 4.6.
532 Upgrade instructions:
534 For package users having samba44 installed indirectly (as a dependency):
537 For package users having samba44 installed directly (leaf port):
539 # pkg install samba46
542 If you want to keep samba44, add DEFAULT_VERSIONS+= samba=4.4 to make.conf
544 If you want to upgrade to samba46, remove samba44:
545 # pkg delete -f samba44
548 # portmaster net/samba46
552 # portinstall net/samba46
556 AFFECTS: users of devel/gogs
559 Gogs user has been changed to "git" and configuration files are now
560 located in /usr/local/etc/gogs. Users should update ownership of the
561 existing Gogs directories with
563 # chown -R git:git /var/db/gogs
564 # chown -R git:git /var/log/gogs
566 and either move or merge the contents of /var/db/gogs/home/.ssh with
567 /usr/local/git/.ssh. After migration, /var/db/gogs/home can be removed,
568 and both the user "gogs" and the group "gogs" should be deleted:
570 # rm -rf /var/db/gogs/home
575 AFFECTS: users of finance/gnucash
576 AUTHOR: madpilot@FreeBSD.org
578 The gnucash port has been converted too use flavors, the GUILE1
579 and GUILE2 options have been converted to flavors so that two
580 separate packages can be provided.
582 Since the next major release of gnucash will drop guile1 support,
583 the default flavor package is compiled against guile2, switching
584 the previous default.
586 Users who intend to stay on the guile1 version should deinstall
587 the default gnucash package and install the gnucash-guile1 package.
590 AFFECTS: all ports users
591 AUTHOR: adamw@FreeBSD.org
593 Support for some deprecated variables is going to be removed soon. If
594 you use any of the following constructs (usually in /etc/make.conf),
595 you must switch to the new incantations:
598 ------------------------------- ------------------------------
599 WITH_[...] OPTIONS_SET= [...]
600 WITHOUT_[...] OPTIONS_UNSET= [...]
601 WITHOUT_NLS OPTIONS_UNSET= NLS
602 NOPORTDOCS OPTIONS_UNSET= DOCS
603 NOPORTEXAMPLES OPTIONS_UNSET= EXAMPLES
604 WITH_BDB_VER=[...] DEFAULT_VERSIONS+= bdb=[...]
605 OVERRIDE_LINUX_BASE_PORT=[...] DEFAULT_VERSIONS+= linux=[...]
606 WITH_OPENSSL_BASE DEFAULT_VERSIONS+= ssl=base
607 WITH_OPENSSL_PORT DEFAULT_VERSIONS+= ssl=port
610 AFFECTS: users of dns/powerdns
611 AUTHOR: krion@FreeBSD.org
613 Recursor passthrough removal: This will impact many installations.
614 Previously, the PowerDNS Authoritative Server contained a facility
615 for sending recursion desired queries to a resolving backend,
616 possibly after first consulting its local cache. This feature
617 (‘recursor=’) was frequently confusing and also delivered
618 inconsistent results, for example when a query ended up referring
619 to a CNAME that was outside of the Authoritative Server’s
623 AFFECTS: users of sysutils/dsbmd
624 AUTHOR: mk@freeshell.de
626 Due to new configuration variables and new features, users of dsbmd
627 version 0.4.1 and earlier should consider recreating their dsbmd.conf from
628 the new dsbmd.conf.sample.
631 AFFECTS: all ports users
632 AUTHOR: adamw@FreeBSD.org
634 The ports tree has gained "flavors," which are a way to produce multiple
635 variations of a port. Some intended examples of this are language
636 modules being produced for multiple language versions, and lite/nox11 packages,
637 without needing separate ports for each variation. Python ports have already
638 been flavored (see the below entry). Flavor support must be added to
641 Flavors are already supported by make, pkg, poudriere, and synth; see the
642 manpages for those tools for usage instructions. Portmaster and portupgrade
643 don't support flavors yet, but community work on those tools is in progress.
645 Some bumps and breakages are inevitable for a major change such as this.
646 Please report breakages and monitor the ports@ list for solutions as they
651 AUTHOR: mat@FreeBSD.org
653 Ports using Python via USES=python are now flavored. All the py3-* ports
654 have been removed and folded into their py-* master ports.
656 People using Poudriere 3.2+ and binary packages do not have to do anything.
658 For other people, to build the Python 3.6 version of, for example,
659 databases/py-gdbm, you need to run:
661 # make FLAVOR=py36 install
664 AFFECTS: users of security/p5-openxpki
665 AUTHOR: dbaio@FreeBSD.org
667 OpenXPKI has been updated to 1.19.4, some important changes were made, please
668 see the upgrading documentation for more details:
670 http://openxpki.readthedocs.io/en/latest/upgrading.html
673 AFFECTS: users of mail/sympa
674 AUTHOR: dgeo@centrale-marseille.fr
676 Web's static dirs have moved to a single dedicated directory.
677 Users should review webserver's /static configuration (examples in
678 share/examples/sympa).
681 AFFECTS: users of sysutils/zrepl
682 AUTHOR: woodsb02@FreeBSD.org
684 Zrepl has been updated to 0.0.2, which introduces two changes that will
685 require existing users to change their zrepl.yml config file:
686 - global.logging is no longer a dictionary but a list.
687 Refer to the new format here: https://zrepl.github.io/configuration/logging.html
688 - source job field datasets renamed to filesystems.
689 Refer to the new format here: https://zrepl.github.io/configuration/jobs.html
691 https://zrepl.github.io/changelog.html#id1
694 AFFECTS: users of sysutils/terraform
695 AUTHOR: lifanov@FreeBSD.org
697 Terraform has been updated to 0.11, which introduces several incompatible
698 changes. Please follow upgrading guide when updating the package.
700 https://www.terraform.io/upgrade-guides/0-11.html
703 AFFECTS: users of ports-mgmt/poudriere
704 AUTHOR: bdrewery@FreeBSD.org
706 "poudriere options" now respects the -p flag while it did not before.
707 This means that it may create an empty directory when used now rather
708 than continue to use your existing options set. You may want to not
709 use -p or move your existing options directory, in
710 /usr/local/etc/poudriere.d/*-options, to the new format with the
711 ports tree name in it. Otherwise "poudriere bulk" will use the
714 This behavior will likely change in 3.2.1 to be more backwards-compatible.
717 AFFECTS: consumers of devel/oniguruma*
718 AUTHOR: riggs@FreeBSD.org
720 Outdated versions of oniguruma have been removed from the ports
721 tree; devel/oniguruma is the only supported version, currently
722 replacing devel/oniguruma6.
723 pkg should handle this automatically while users of portmaster or
724 portupgrade might need to take additional manual steps:
726 for users of portmaster:
727 portmaster -o devel/oniguruma devel/oniguruma6
728 portmaster -r devel/oniguruma
730 for users of portupgrade:
731 portupgrade -o devel/oniguruma devel/oniguruma6
732 portupgrade -fr devel/oniguruma
735 AFFECTS: users of www/node
736 AUTHOR: bhughes@FreeBSD.org
738 The www/node port has been updated to node.js v9.0.0, the latest
739 upstream release. A new port, www/node8, has been created for the
740 v8.x LTS branch. Users wanting to stay on v8.x can replace www/node
741 with www/node8 with one of the following commands:
743 # pkg install www/node8
745 # portmaster -o www/node8 www/node
747 # portupgrade -o www/node8 www/node
750 AFFECTS: users of security/libressl
751 AUTHOR: brnrd@FreeBSD.org
753 The port has been updated to the latest stable version 2.6 of LibreSSL.
754 The shared library versions of the libraries have been bumped.
756 After upgrading, manually update all packages that depend on any of the
757 libraries provided by LibreSSL (libssl, libcrypto and libtls) since the
758 versions of these libraries have changed. Normally, you can obtain the
759 list of dependent software by running the following command:
761 # pkg info -r libressl
763 Then you should rebuild all ports depending on libressl to avoid dangling
764 shared library dependencies. Poudriere and pkg handle this correctly,
765 portmaster and portupgrade users can use the following to rebuild all
769 portmaster -r libressl
771 portupgrade -fr security/libressl
774 AFFECTS: users of www/mod_auth_cas
775 AUTHOR: brnrd@FreeBSD.org
777 The configuration of mod_auth_cas has changed since the previous
778 version. Visit the https://github.com/apereo/mod_auth_cas page for
779 an overview of all configuration parameters
782 AFFECTS: users of www/mod_rpaf2
783 AUTHOR: brnrd@FreeBSD.org
785 The configuration of mod_rpaf2 has been heavily modified since version
786 0.6. Have a look at https://github.com/gnif/mod_rpaf/tree/v0.8.4 to
787 determine what you need to change in your configuration.
790 AFFECTS: users of editors/vim
791 AUTHOR: adamw@FreeBSD.org
793 The default vim language bindings have changed. Python 2 and 3 bindings
794 may now be enabled independently (the default vim package will continue
795 to depend on python-2.7).
797 Lua and Tcl bindings have been disabled by default. If you need these
798 bindings, you'll need to compile vim yourself. Note that bindings are
799 only for plugins written in those languages, and for interactive
800 debugging. Editing, indenting, linting, completing, and syntax-highlighting
801 those languages is NOT affected.
804 AFFECTS: users of devel/universal-ctags
805 AUTHOR: rodrigo@FreeBSD.org
807 Due to conflicts with emacs ctag (editors/emacs-devel, editors/emacs-nox11, editors/emacs),
808 the installed files will be prefixed with the 'u' character.
809 The new binaries will de named uctags and ureadtags.
812 AFFECTS: people using WITHOUT_DEBUG
813 AUTHOR: madpilot@FreeBSD.org
815 The WITHOUT_DEBUG flag has been retired. It's only purpose was
816 to override a global WITH_DEBUG, if that was defined, but many
817 ports were ignoring such flag even if honouring WITH_DEBUG.
819 The same effect can be obtained using ".undef WITH_DEBUG" without
820 any special support in port Makefiles.
823 AFFECTS: users of security/openssh-portable
824 AUTHOR: bdrewery@FreeBSD.org
826 OpenSSH has been upgraded to 7.6p1 which has removed several deprecated
829 - SSH version 1 support dropped.
830 - Dropped support for hmac-ripemd160 MAC.
831 - Dropped support for the ciphers arcfour, blowfish and CAST.
832 - RSA keys less than 1024 bits are refused.
834 The HPN option is currently disabled by default, and does not build,
835 in the package. This follows what happened in base as well.
838 AFFECTS: users of security/krb5-appl
839 AUTHOR: cy@FreeBSD.org
841 Configuration options to rename kerberos ftp, telnet, rlogin, rsh, and
842 rcp are now default to avoid conflicting with net/bsdrcmds packages
843 (in poudriere). Deselect the options to use the original command names
844 and also uninstall net/bsdrcmds to avoid the conflict.
847 AFFECTS: users of x11-wm/cwm
848 AUTHOR: tobik@FreeBSD.org
850 Configuration options were renamed and you need to update your ~/.cwmrc
851 accordingly. Make sure to check cwmrc(5) for the new option names.
852 cwm-migrate-config.pl can help in migrating your ~/.cwmrc.
855 AFFECTS: users of mail/isync using Maildir sub-folders
856 AUTHOR: ehaupt@FreeBSD.org
858 If you have Maildir sub-folders, you need to update the configuration
859 to specify the naming style.
861 Please refer to the mbsync(1) man page section 'SubFolders
862 Verbatim|Maildir++|Legacy' on how to make the apropriate changes.
865 AFFECTS: users of PHP and its modules
866 AUTHOR: eugen@FreeBSD.org
868 All lang/php* ports switched to depend on devel/oniguruma6
869 instead of previous oniguruma version some time ago.
871 If you have not moved from devel/oniguruma5 before and
872 have troubles updating PHP,
874 for users of portmaster:
875 portmaster -o devel/oniguruma6 devel/oniguruma5
876 portmaster -r devel/oniguruma6
878 for users of portupgrade:
879 portupgrade -o devel/oniguruma6 devel/oniguruma5
880 portupgrade -fr devel/oniguruma6
882 pkg should handle this automatically.
885 AFFECTS: users of security/courier-authlib and its modules
886 AUTHOR: madpilot@FreeBSD.org
888 The affected ports have been modified to follow the upstream
889 suggested best practice to use the sysconftool on installation.
891 Please make sure your configuration files include all the comments
892 that tool uses to correctly update the configuration on update.
894 You can use the ".sample" or ".dist" files as templates for missing
898 AFFECTS: users of devel/cargo
899 AUTHOR: rust@FreeBSD.org
901 Starting with version 1.19.0, Cargo is provided with Rust. Therefore,
902 devel/cargo was merged into lang/rust.
905 AFFECTS: users of CMake & CMake Modules
906 AUTHOR: adridg@FreeBSD.org
908 The devel/cmake-modules port has been merged into devel/cmake.
910 The benefit of being able to update the modules without the binary
911 is outweighed by the issues caused by having the binary out-of-sync
914 Users should delete the devel/cmake-modules package and then
915 upgrade or reinstall devel/cmake.
917 All ports have been updated to depend only on CMake.
920 AFFECTS: users of net-mgmt/seafile-server
921 AUTHOR: ultima@FreeBSD.org
923 Users using MySQL updating to 6.1.2 need to verify table's collation
924 are utf8_unicode_ci. Upstream has set collation type to be implicit
925 and will cause all libraries to disappear if set to incorrect collation.
928 AFFECTS: users of security/gnupg
929 AUTHOR: adamw@FreeBSD.org
931 security/gnupg has become the new stable version of GnuPG. This is
932 an LTS branch. gnupg20 will reach EOL at the end of the year, and all
933 gnupg20 users should migrate to gnupg22.
935 See https://gnupg.org/faq/whats-new-in-2.1.html for important changes.
938 AFFECTS: users of www/uwsgi
939 AUTHOR: ultima@FreeBSD.org
941 The default socket owner and mode had been changed from www:www 600
942 to uwsgi:www 660. This should resolve issue #1471[1] on github.
944 [1] https://github.com/unbit/uwsgi/issues/1471
947 AFFECTS: users of lang/ghc and */hs-*
948 AUTHOR: haskell@FreeBSD.org
950 The Glorious Glasgow Haskell Compiler has been updated to version
951 8.0.2. Hence it is recommended to rebuild or reinstall all the
952 dependent ports and the lang/ghc port itself in one of the following
955 # portmaster -w -r ghc
957 # portupgrade -fr lang/ghc
959 In case of pkg(8), it is probably safer to remove all the GHC-dependent
960 packages along with GHC and reinstall everything from scratch. For
963 # pkg query "%ro" ghc > ghc-pkgs.txt
964 # pkg delete -y lang/ghc
966 In ghc-pkgs.txt, check and remove all the packages that have been moved
967 on the update, then use this command:
969 # pkg install -y `cat ghc-pkgs.txt`
972 AFFECTS: users of mail/dovecot2 and mail/dovecot2-pigeonhole
973 AUTHOR: adamw@FreeBSD.org
975 Now that dovecot1 has been removed from the ports tree, dovecot2
976 and dovecot2-pigeonhole have been renamed to simply dovecot and
979 pkg should handle the rename automatically, but if you run into
980 trouble, you can point pkg at the new origin via:
982 # pkg set -o mail/dovecot2:mail/dovecot
983 # pkg set -o mail/dovecot2-pigeonhole:mail/dovecot-pigeonhole
985 Similarly, you can point portmaster at the new location via:
987 # portmaster -o mail/dovecot mail/dovecot2
989 If all else fails, just remove and reinstall the package:
991 # pkg delete dovecot2
992 # pkg install dovecot
995 AFFECTS: users of mail/dovecot2-antispam-plugin
996 AUTHOR: adamw@FreeBSD.org
998 Development of the antispam plugin ceased years ago, and upstream
999 recommends using pigeonhole (mail/dovecot2-pigeonhole) instead.
1001 See https://wiki2.dovecot.org/HowTo/AntispamWithSieve for a recipe
1002 to replicate the antispam plugin's behaviour.
1005 AFFECTS: users of net/guacamole-client
1006 AUTHOR: ultima@FreeBSD.org
1008 As of version 0.9.13, the configuration directory for guacamole-client
1009 has changed from /usr/local/etc/guacamole to
1010 /usr/local/etc/guacamole-client.
1013 AFFECTS: users of net/guacamole-server
1014 AUTHOR: ultima@FreeBSD.org
1016 As of version 0.9.13, the configuration directory for guacamole-server
1017 has changed from /usr/local/etc/guacd to /usr/local/etc/guacamole-server.
1020 AFFECTS: users of sysutils/terraform
1021 AUTHOR: lifanov@FreeBSD.org
1023 Terraform was updated to version 0.10.0, which split out provider plugins.
1024 Provider plugins are now installed in the project directory the next time
1025 "terraform init" is run. Please see the complete upgrading guide:
1027 https://www.terraform.io/upgrade-guides/0-10.html
1030 AFFECTS: users of net-p2p/bitcoin
1031 AUTHOR: lwhsu@FreeBSD.org
1033 Bitcoin data directory has been changed from /var/db/bitcoind to
1034 /var/db/bitcoin. Users of previous versions may want to migrate data to
1035 new location or specify bitcoind_data.
1038 AFFECTS: users of mail/mailscanner
1039 AUTHOR: crees@FreeBSD.org
1041 Version 5.0.3 of MailScanner introduced a serious bug in packaging.
1042 Unfortunately if it is installed, your configuration has been deleted.
1044 If you have managed to get it working, please back up
1045 /usr/local/etc/MailScanner as it will also be deleted on deinstall
1046 of the same package.
1049 AFFECTS: users of www/luakit
1050 AUTHOR: ports@textmail.me
1052 Luakit was updated to version 2017.07.26, which is incompatible to the
1053 previous release from 2012. Please remove old configuration files from
1054 the following directories:
1055 ${PREFIX}/etc/xdg/luakit
1056 ${HOME}/.config/luakit
1057 ${HOME}/.local/share/luakit
1060 AFFECTS: users of security/sshguard*
1061 AUTHOR: dan.mcgregir@usask.ca
1063 security/sshguard was updated to 2.0.0, and security/sshguard-pf,
1064 security/sshguard-ipfw, and security/sshguard-null have been merged into
1067 Configuration of the service is now handled in ${PREFIX}/etc/sshguard.conf.
1068 Please select the desired backend, -null is selected by default.
1070 In order to upgrade from 1.7.1 change the origin to security/sshguard
1072 # pkg set -o security/sshguard-ipfw:security/sshguard
1073 # pkg set -o security/sshguard-null:security/sshguard
1074 # pkg set -o security/sshguard-pf:security/sshguard
1077 AFFECTS: users of devel/p5-Log-Any and devel/p5-Log-Any-Adapter-Syslog
1078 AUTHOR: eugen@FreeBSD.org
1080 devel/p5-Log-Any-Adapter-Syslog functionality have been merged into
1081 devel/p5-Log-Any and from now devel/p5-Log-Any must be used.
1083 devel/p5-Log-Any-Adapter-Syslog will be marked as deprecated and removed.
1086 AFFECTS: users of devel/apr1
1087 AUTHOR: brnrd@FreeBSD.org
1089 APR was updated to 1.6.0 and APR-util was updated to 1.6.2
1091 The Apache Portable Runtime project removed support for FreeTDS from the
1092 APR Utilities in version 1.6. Users of FreeTDS will have to migrate
1093 configurations to use the newly added ODBC support in conjunction with
1094 FreeTDS using FreeTDS' ODBC capabilities.
1096 Please rebuild all ports which are using functions from APR/APR-util
1097 such as Apache, Subversion, etc. Normally, you can obtain the list of
1098 dependent software by running the following command:
1102 Then you should rebuild all ports depending on APR(-util) to avoid
1103 dangling shared library dependencies. Poudriere and pkg handle this
1104 correctly, portmaster and portupgrade users can use the following to
1105 rebuild all dependent ports.
1110 portupgrade -fr devel/apr1
1113 AFFECTS: users of net-im/ejabberd
1114 AUTHOR: ashish@FreeBSD.org
1116 After update to 17.07, there is an issue[1] expected related to certificate
1117 verification with TLS connections.
1119 [1] - https://github.com/processone/ejabberd/issues/1833
1122 AFFECTS: users of www/node
1123 AUTHOR: bhughes@FreeBSD.org
1125 The www/node port has been updated to Node.js v8.1.2, the latest
1126 upstream release. This is a major release, including many significant
1127 changes. Users are encouraged to read the release announcements before
1130 https://nodejs.org/en/blog/release/v8.0.0/
1131 https://nodejs.org/en/blog/release/v8.1.0/
1134 AFFECTS: users of net-mgmt/zabbix24*
1135 AUTHOR: dbaio@FreeBSD.org
1137 Zabbix 2.4 has reached end of life and net-mgmt/zabbix24* ports have been
1138 removed. Users that have not yet moved to a newer version, should use now
1139 net-mgmt/zabbix3-* (LTS release) or net-mgmt/zabbix32-* (Standard release).
1141 See more info about Zabbix releases here:
1142 http://www.zabbix.com/life_cycle_and_release_policy
1145 AFFECTS: users of mail/dcc-dccd
1146 AUTHOR: ultima@FreeBSD.org
1148 The ALT_HOME option was removed in 1.3.159_1. If this option is being
1149 used, please be sure to move the old home directory, /var/dcc to
1153 AFFECTS: users of net/rabbitmq
1154 AUTHOR: olgeni@FreeBSD.org
1156 The rabbitmq-3.6.10_1 port has been changed to use version 19 of
1157 the Erlang runtime, because RabbitMQ is not yet compatible with
1160 Upgrades to the previous rabbitmq-3.6.10 must be avoided as
1161 they can lead to data corruption due to changes in Erlang 20.
1164 AFFECTS: users of database/postgresql* and other software using PostgreSQL to run
1165 AUTHOR: tz@FreeBSD.org
1167 The default version of PostgreSQL has been switched from 9.3 to 9.5.
1168 The upgrade procedure can use up twice the space the databases
1169 currently needs. If you have a big amount of stored data take a
1170 closer look at the manpage of pg_upgrade for avoidance and/or
1171 speedup of the upgrade.
1173 The upgrade instructions consider a basic usage and do not match
1174 complex scenarious like replication, sharding or similar.
1176 Upgrade instructions:
1178 First stop your PostgreSQL, create PostgreSQL-binaries and backup your data.
1179 If you have another Version of PostgreSQL installed, for example 9.3.12, your
1180 files are named accourding to this.
1182 # service postgresql stop
1183 # pkg create postgresql93-server postgresql93-contrib
1184 # mkdir /tmp/pg-upgrade
1185 # tar xf postgresql93-server-9.3.17.txz -C /tmp/pg-upgrade
1186 # tar xf postgresql93-contrib-9.3.17.txz -C /tmp/pg-upgrade
1187 # mv /usr/local/pgsql/data /usr/local/pgsql/data93
1188 # pkg delete -f databases/postgresql93-server databases/postgresql93-contrib databases/postgresql93-client
1190 Now update PostgreSQL:
1193 # pkg install databases/postgresql95-server databases/postgresql95-contrib
1197 # portmaster databases/postgresql95-server databases/postgresql95-contrib
1201 # portinstall databases/postgresql95-server databases/postgresql95-contrib
1204 After installing the new PostgreSQL version you need to convert
1205 all your databases to new version:
1207 # service postgresql initdb
1208 # su -l pgsql -c "pg_upgrade -b /tmp/pg-upgrade/usr/local/bin/ -d /usr/local/pgsql/data93/ -B /usr/local/bin/ -D /usr/local/pgsql/data/"
1210 Now the migration is finished. You can start PostgreSQL again with:
1212 # service postgresql start
1215 AFFECTS: users of editors/calligra
1216 AUTHOR: groot@kde.org
1218 Calligra has been updated to 3.0.1, which is a KDE Frameworks 5 (KF5)
1219 based application. Calligra now uses Qt5 and KF5. The translations have
1220 been merged (upstream) into the application, so separate language /
1221 translation ports are no longer provided. Krita has been split out
1222 (upstream) into a separate application, which is packaged as
1223 graphics/krita. Kexi, the visual database applications creator,
1224 is packaged separately as databases/kexi.
1226 Users of Calligra are encouraged to install Krita and Kexi separately,
1227 and to report issues with the upgrade to kde@.
1230 AFFECTS: users of net-im/ejabberd
1231 AUTHOR: ashish@FreeBSD.org
1233 After update to 17.04, there is an issue[1] expected with S2S connections,
1234 which can be resolved by adding 'mod_s2s_dialback: {}' to 'modules' section
1235 of configuration file.
1237 [1] - https://github.com/processone/ejabberd/issues/1700
1240 AFFECTS: users of www/kanboard
1241 AUTHOR: joneum@FreeBSD.org
1243 After update to 1.0.44, there are following breaking changes:
1244 * Move calendar to external plugin: https://github.com/kanboard/plugin-calendar
1245 * Move Gantt charts to external plugin: https://github.com/kanboard/plugin-gantt
1246 * Move Gravatar to external plugin: https://github.com/kanboard/plugin-gravatar
1249 AFFECTS: users of Qt 5 in presence of binutils
1250 AUTHOR: amdmi3@FreeBSD.org
1252 gold linker from binutils 2.28 may produce duplicate library
1253 symbols, which makes shared libraries created with it not usable
1254 with conventional ld linker.
1256 This affects Qt, as qt5-qmake will detect gold and use it to build
1257 Qt libraries. Broken libQt5Core will be produced and ports which
1258 depend on it will then fail to link with the following errors:
1260 ...lib/libQt5Core.so:(.dynamic+0x27ac8): multiple definition of `__bss_start at Qt_5'
1261 ...lib/libQt5Core.so:(.dynamic+0x27ac8): first defined here
1262 ...lib/libQt5Core.so:(.dynamic+0x27ac8): multiple definition of `_edata at Qt_5'
1263 ...lib/libQt5Core.so:(.dynamic+0x27ac8): first defined here
1264 ...lib/libQt5Core.so:(.dynamic+0x2b2d0): multiple definition of `_end at Qt_5'
1266 Qt5 was fixed to ignore gold. If you see these errors, you
1267 need to rebuild qt5-qmake, then all qt5-* ports.
1270 AFFECTS: users of sysutils/dsbmd
1271 AUTHOR: mk@freeshell.de
1273 Due to new configuration variables and semantic changes, users of dsbmd
1274 version 0.2 and earlier should consider recreating their dsbmd.conf from
1275 the new dsbmd.conf.sample.
1278 AFFECTS: users of www/yarn
1279 AUTHOR: adamw@FreeBSD.org
1281 The default node backend for yarn has switched to www/node. Binary
1282 package users should expect the node backend to be switched during
1283 the upgrade. To keep the node6 (LTS) backend, rebuild www/yarn with
1284 the NODE6 backend option enabled.
1287 AFFECTS: users of security/pecl-ssh2
1288 AUTHOR: dbaio@FreeBSD.org
1290 The security/pecl-ssh2 has been upgraded to version 1.0, and the new
1291 version is not compatible with PHP5. If you need PHP5 support, you can
1292 find version 0.13 in security/pecl-ssh2-0.