-
Notifications
You must be signed in to change notification settings - Fork 865
Expand file tree
/
Copy pathUPDATING
More file actions
5378 lines (3999 loc) · 189 KB
/
Copy pathUPDATING
File metadata and controls
5378 lines (3999 loc) · 189 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
This file documents some of the problems you may encounter when upgrading
your ports. We try our best to minimize these disruptions, but sometimes
they are unavoidable.
You should get into the habit of checking this file for changes each time
you update your ports collection, before attempting any port upgrades.
20260724:
AFFECTS: users of news/inn, news/inn-current
AUTHOR: kbowling@FreeBSD.org
The BERKELEYDB option now depends on databases/db18 instead of
databases/db5 (EOL). If you use the ovdb overview method, stop the
news system, upgrade the port, then upgrade the overview database
in-place as the news user before restarting:
# service innd stop
# pkg upgrade news/inn # or rebuild from ports
# su -m news -c 'ovdb_init -u'
# service innd start
The upgrade is in-place and cannot be undone. See ovdb_init(8) for
details. Users not using ovdb can ignore this entry.
20260721:
AFFECTS: users of security/openssh-portable
AUTHOR: bdrewery@FreeBSD.org
The OpenSSH HPN option and flavor are deprecated and will be removed.
Base removed the patch in 2016, and the patch has not matched upstream
in many years. The new upstream is named "hpn-ssh". It may be revived
as a separate package/port in the future.
To switch the package:
# pkg set -n openssh-portable-hpn:openssh-portable
Remove these options:
sshd_config:
- NoneEnabled
- HPNDisabled
- HPNBufferSize
- TcpRcvBufPoll
ssh_config:
- NoneEnabled
- NoneSwitch
- TcpRcvBufPoll
- TcpRcvBuf
- HPNDisabled
- HPNBufferSize
20260708:
AFFECTS: users of net/croc
AUTHOR: olgeni@FreeBSD.org
The croc rc script now honors an optional croc_host variable that binds
the relay to a specific local address instead of all interfaces.
This is needed on hosts with IP forwarding enabled (typically routers),
where the "croc relay" startup self-check connects to the wildcard
address (0.0.0.0) and fails with "network is unreachable", causing the
relay to exit immediately. If your relay does not stay running, set a
local address of the host in /etc/rc.conf, for example:
croc_host="192.0.2.1"
Leaving croc_host empty (the default) keeps the previous behavior of
listening on all interfaces.
20260707:
AFFECTS: users of mail/bogofilter
AUTHOR: mandree@FreeBSD.org
Due to the LMDB 1.0 incompatibility (see 20260702 entry for
databases/lmdb), mail/bogofilter currently depends on lmdb0
so it can continue using existing wordlist.lmdb databases.
For users who wish to transition to LMDB 1.0.0, please:
- identify all wordlist.lmdb files, and
- for each of them, run:
bogoutil -d /path/to/wordlist.ldmb >/path/to/wordlist.txt
- THEN you can install to mail/bogofilter-lmdb1,
- for each of the wordlist.lmdb files, move them to a safe
place, and recreate them from the text file, i.e.
for each, run:
bogoutil -l /path/to/wordlist.lmdb </path/to/wordlist.txt
At a later point, we will upgrade mail/bogofilter to refer
to lmdb 1.0 and remove the bogofilter-lmdb1 port.
20260702:
AFFECTS: users of databases/lmdb
AUTHOR: delphij@FreeBSD.org
LMDB 1.0 introduced an incompatible on-disk file format change.
Versions 0.9.x and 1.0.x databases are mutually incompatible.
Before upgrading, export all existing databases using the old v0.9
mdb_dump utility, then import them with the new v1.0 mdb_load after
upgrading. There is no support for opening v0.9 database files
directly with LMDB 1.0.
Example migration procedure:
# mdb_dump -a /path/to/db > /tmp/mydb.dump
# pkg upgrade databases/lmdb
# mdb_load -f /tmp/mydb.dump /path/to/newdb
20260630:
AFFECTS: users of audio/murmur
AUTHOR: vvd@FreeBSD.org
Branch 1.3 is deprecated by upstream. Also it doesn't support OpenSSL 3.
Port audio/murmur removed from tree - use audio/mumble-server instead.
Upstream has renamed murmur to mumble-server, so when upgrading to
version 1.5.x, you need to do the following:
1. Before upgrade stop server:
service murmur stop
2. Rename all working files and directories:
mv /var/db/murmur/murmur.sqlite /var/db/murmur/mumble-server.sqlite
mv /var/db/murmur /var/db/mumble-server
mv /var/log/murmur/murmur.log /var/log/murmur/mumble-server.log
mv /var/log/murmur /var/log/mumble-server
mv /var/run/murmur /var/run/mumble-server
3. Backup murmur.ini:
mv /usr/local/etc/murmur.ini /usr/local/etc/murmur.ini.old
4. Remove port audio/murmur and install audio/mumble-server.
5. Remove old user and group murmur:
pw userdel murmur
pw groupdel murmur
6. Change owner of old files:
chown -R mumble-server:mumble-server /var/db/mumble-server \
/var/log/mumble-server /var/run/mumble-server
7. Add your customizations in /usr/local/etc/mumble/mumble-server.ini.
8. Update /etc/rc.conf:
replace murmur_enable="YES" with mumble_server_enable="YES".
9. Start server:
service mumble_server start
20260630:
AFFECTS: users of net-im/gotosocial
AUTHOR: tilde@ultros.pro
net-im/gotosocial has been updated to 0.22.0
New configuration options have been added and the upgrade involves
lengthy database migrations (allow upwards of 30 minutes) which must not
be interrupted.
Upgrade procedure:
1. # service gotosocial stop
2. Backup database
3. # pkg upgrade gotosocial
4. Merge new options from etc/gotosocial/config.yaml.sample
5. # service gotosocial start (do not interrupt database migrations!)
PostgreSQL users will need to perform the following manual steps in
addition:
6. Connect to gotosocial database using `psql` command
7. VACUUM FULL;
8. VACUUM FULL ANALYZE;
9. VACUUM (DISABLE_PAGE_SKIPPING ON);
10. # service gotosocial restart
See details at https://codeberg.org/superseriousbusiness/gotosocial/releases/tag/v0.22.0
20260628:
AFFECTS: users of www/gitea
AUTHOR: nxjoseph@FreeBSD.org
Gitea 1.26.3 tightens the fork pull request approval gate:
a pull request from a fork must now be merged before it can bypass
the approval gate (#38041). Review your workflow approval settings
if you rely on the previous behavior.
https://github.com/go-gitea/gitea/pull/38041
20260626:
AFFECTS: net-mgmt/netbox
AUTHOR: kai@FreeBSD.org
1. With Release Netbox 4.6, Python 3.12 or newer is now required.
This was actually already the case with previous NetBox 4.5 release,
but it could be worked around using smaller patches to ensure
compatibility with older Python releases.
2. Please also check the pkg-message and the changelogs for further info.
20260624
AFFECTS: Python users
AUTHOR: vishwin@FreeBSD.org
The default version of python has been switched to 3.12.
For ports users wanting to keep version 3.11 as default,
add DEFAULT_VERSIONS+= python=3.11 to make.conf
With packages, the following may ease the process:
# pkg set -p -n py311-:py312-
# pkg upgrade
If no longer required, Python 3.11 can be removed via
"pkg remove python311" and the directory /usr/local/lib/python3.11 can
then be deleted afterwards, if not empty.
20260616:
AFFECTS: Users of security/gnupg, security/gnupg25, security/gnupg1
AUTHOR: adridg@FreeBSD.org
GnuPG 2.4 reaches end-of-life in July 2026. The 2.5 series is declared
stable upstream. Port security/gnupg25 will be retired and security/gnupg
is updated to the 2.5 series. As a result, users of security/gnupg25 must
switch (back) to security/gnupg. GnuPG 2.5 is backwards-compatible
with 2.4 and regular users of security/gnupg should experience no issues.
Upstream has removed co-installability with GnuPG 1.4, users that install
both security/gnupg and legacy security/gnupg1 will have to uninstall one.
20260616:
AFFECTS: Users of net-mgmt/librenms
AUTHOR: dvl@FreeBSD.org
LibreNMS 26.6.0 bring in a sizeable refactor to the rrd processes.
A new configuration item is required for the font-cache directory.
Add this entry to $PREFIX/librenms.env
XDG_CACHE_HOME=/var/db/librenms/font-cache
20260614:
AFFECTS: Users of www/mattermost-server
AUTHOR: decke@FreeBSD.org
Mattermost 11.x dropped support for MySQL / MariaDB database.
If you are affected please read the migration guidelines before updating:
https://docs.mattermost.com/deployment-guide/postgres-migration.html
20260609:
AFFECTS: Users of x11-wm/mango
AUTHOR: nivit@FreeBSD.org
Version 0.14.0 of Mango has some breaking changes:
- IPC Protocol Upgrade: The old dwl IPC protocol is now deprecated and will
be removed in the next version.
- Socket Restructuring: mmsg(1) now restricts the use of independent sockets.
This structural change delivers a more powerful, concise, and reliable
syntax, allowing you to seamlessly retrieve data for all clients, tags,
monitors, and messages.
As a result, you must adapt any script that uses the mmsg(1) command to
the new syntax.
20260605:
AFFECTS: Users of dns/dnsmasq-devel
AUTHOR: mandree@FreeBSD.org
The dns/dnsmasq-devel port has been unable to keep the pace of the upstream
releases due project admin issues beyond its maintainer's control. At the
same time, dns/dnsmasq is now at the 2.93 release, thus newer than
dnsmasq-devel. The -devel port is no longer useful at this time.
Users are sought to replace the dnsmasq-devel port and install dnsmasq
instead. The configuration including rc.conf settings are compatible,
so a simple "pkg install dnsmasq" or, for portmaster users,
"portmaster -o dns/dnsmasq dns/dnsmasq-devel" should achieve that.
20260601:
AFFECTS: Users of security/lego
AUTHOR: matt@matthoran.com
To migrate from lego v4 to v5 run
$ lego migrate --path PREFIX/etc/ssl/lego
as the LEGO_USER user. This command migrates to a new file structure and
outputs configuration that can be used as the basis for ETCDIR/lego.yml. See
https://go-acme.github.io/lego/references/ref-file/index.html for more
details on the configuration file format.
ETCDIR/lego.sh will need to be updated as well, as the renew command has been
removed. The script can also be simplified when a configuration file is used.
See ETCDIR/lego.sh.sample for an example.
20260531:
AFFECTS: Users of x11-wm/hyprland
AUTHOR: tagattie@FreeBSD.org
Starting from version 0.55.0, Hyprland supports Lua-based
configuration syntax. The old hyprlang-based configuration is
deprecated and will be supported for a few more releases. After
that, old configuration will be dropped. Users are encouraged to
migrate from the hyprlang-based configuration to the Lua-based
one. For more details, please visit the following URLs:
https://hypr.land/news/26_lua/
https://wiki.hypr.land/Configuring/
20260515:
AFFECTS: Users of net/rsync
AUTHOR: rodrigo@FreeBSD.org
Since rsync 3.4.2, the rsync project removed support for the unmaintained
rsync-patches archive. As a consequence options such as File system flags
(--fileflags) are not available anymore in default build.
20260510:
AFFECTS: Users of games/minecraft-server
AUTHOR: freebsd.tug890@passmail.net
The file structure of how worlds and their data are stored have been
changed since new 26.1 version.
If you upgrade from a version older than 26.1 (v1.21.11 for example),
you can get the following error during wold upgrade:
"
net.minecraft.util.filefix.virtualfilesystem.exception.CowFSSymlinkException:
Cannot build copy-on-write file system when symlink is present: ./world
"
To successfully migrate your world, you must relocate /var/db/minecraft
content in /usr/local/minecraft/world, then launch 'minecraft-server'
as usual.
When 'world' upgrade is finished, stop 'minecraft-server' then relocate
your world in initial folder /var/db/minecraft-server.
Approximate list of commands:
# service minecraft stop
# mv /usr/local/minecraft/world /usr/local/minecraft/world.bak
# mv /var/db/minecraft-server /usr/local/minecraft/world
# service minecraft start
Wait until the conversion is complete.
# service minecraft stop
# mv /usr/local/minecraft/world /var/db/minecraft-server
# /usr/local/minecraft/world.bak /usr/local/minecraft/world
# service minecraft start
Enjoy!
20260508:
AFFECTS: users of shells/bash-completion
AUTHOR: michaelo@FreeBSD.org
Port does not depend on shells/bash{,-static} anymore. Install the port
directly. See PR 292138 and 292501 for details.
20260425:
AFFECTS: Users of security/openssh-portable
AUTHOR: bdrewery@FreeBSD.org
Some defaults have changed to match src.
- X11Forwarding default has changed from "yes" to "no".
- PermitRootLogin default has changed from "prohibit-password" to "no".
20260418:
AFFECTS: Users of net/rsync and net/rsync@python
AUTHOR: rodrigo@FreeBSD.org
Revert the introduction of two net/rsync flavours, the default without
the rrsync script and the python flavour with rrsync and python as a dependency.
Restore the previous setup with a single net/rsync package that includes
the rrsync script but does not depend on Python.
Users who require the rrsync script must install Python separately,
as indicated in the install message.
20260412:
AFFECTS: Users of sysutils/ansible
AUTHOR: cy@FreeBSD.org
An overhaul of the templating system and a new feature called Data Tagging
may affect existing roles resulting in problematic behaviours. Users should
review the Ansible 12 Porting Guide at
https://docs.ansible.com/projects/ansible/devel/porting_guides/porting_guide_12.html
20260412:
AFFECTS: Users of sysutils/py-ansible-core
AUTHOR: cy@FreeBSD.org
A number of behavioural changes may affect existing playbooks and roles.
Users are encouraged to review the Ansible-core 2.19 Porting Guide at
https://docs.ansible.com/ansible/latest/porting_guides/porting_guide_core_2.19.html
20260411:
AFFECTS: users of elisp (*-emacs_*) packages
AUTHOR: jrm@FreeBSD.org
Packages for different flavors of elisp ports have been removed. For
example, the old and new packages for devel/tablist are:
|-------------------------+---------|
| Before | After |
|-------------------------+---------|
| tablist | tablist |
| tablist-emacs_canna | |
| tablist-emacs_devel_nox | |
| tablist-emacs_devel | |
| tablist-emacs_nox | |
| tablist-emacs_wayland | |
|-------------------------+---------|
If you have any -emacs_* packages installed, simply running `pkg upgrade`
will not upgrade and replace them with the new package. Run these commands
under /bin/sh with superuser privileges before upgrading.
for i in $(pkg query -g %n *-emacs_*); do
if [ "$i" != "notmuch-emacs_*" ]; then
nn=$(echo "$i" | sed -e 's/-emacs_[a-z_]*//')
else
nn=$(echo "$i" | sed -e 's/-emacs_[a-z_]*/-emacs/')
fi
pkg set -yn "$i":"$nn"
done
If you are building ports in an unclean environment, you may have to specify
the Emacs build flavor to avoid conflicts. For example, if you have the
default flavor of editors/emacs installed, add the following to
/etc/make.conf:
DEFAULT_VERSIONS+=emacs=full
Possible values are: full, canna, nox, wayland, devel_full, and devel_nox.
Values prefixed with devel_ select editors/emacs-devel; others select
editors/emacs. The default is nox.
20260401:
AFFECTS: users of security/openvpn
AUTHOR: mandree@FreeBSD.org
The openvpn 2.7 port update no longer installs the openvpn-client.up
and openvpn-client.down scripts into libexec/, but instead a
dns-updown script into libexec/openvpn/.
Review your configuration, and the openvpn man page for --dns-updown.
20260329:
AFFECTS: users of java/openjdk25 and java/openjdk26 with the jre flavor
AUTHOR: jrm@FreeBSD.org
The openjdk-jre packages for versions 25 and 26 have been renamed. Users with
the old package names installed should run the following /bin/sh script with
superuser privileges before upgrading.
jre=$(pkg query -g %n-%v "*openjdk-jre-25*" "*openjdk-jre-26*")
if echo "$jre" | grep -q "\-25"; then
on=$(pkg query -g %n "*openjdk-jre-25*")
nn="openjdk25-jre"
elif echo "$jre" | grep -q "\-26"; then
on=$(pkg query -g %n "*openjdk-jre-26*")
nn="openjdk26-jre"
fi
if [ -n "$nn" ]; then
pkg set -yn "$on":"$nn"
fi
20260327:
AFFECTS: users of x11/nvidia-{driver, kmod}
AUTHOR: junchoon@dec.sakura.ne.jp
x11/nvidia-driver and x11/nvidia-kmod are upgraded to latest
Production Branch [PB] of upstream driver package.
Just as -devel variant upgraded 20260103, this version drops
support for a bunch of old (pre-Turing generations of
architecture) GPUs.
You can find still supported GPUs below.
https://us.download.nvidia.com/XFree86/FreeBSD-x86_64/595.58.03/README/supportedchips.html
So anyone using related ports
x11/nvidia-kmod
x11/nvidia-driver
graphics/nvidia-drm-{510|515|61|66|latest}-kmod
x11/linux-nvidia-libs
with dropped GPUs needs to switch to newly added legacy 580 ports.
x11/nvidia-kmod-580
x11/nvidia-driver-580
graphics/nvidia-drm-{510|515|61|66|latest}-kmod-580
x11/linux-nvidia-libs-580
Deinstalling master ports above and reinstalling -580 variant of
ports above would do the right things.
If any of above hesitates to upgrade with version conflicts
of graphics/eglexternalplatform, upgrade it first and retrying
failed ones should help.
20260326:
AFFECTS: users of databases/mysql80-(server|client)
AUTHOR: joneum@FreeBSD.org
The default MySQL version has been updated from 8.0 to 8.4.
If you compile your own ports you may keep 8.0 as the default version by
adding the following lines to your /etc/make.conf file:
#
# Keep MySQL 8.0 as default version
#
DEFAULT_VERSIONS+=mysql=8.0
If you wish to update to the new default version, you need to first stop any
running server instance. Then, you will need to follow these steps, depending
on installed packages.
# pkg set -o databases/mysql80-client:databases/mysql84-client
# pkg set -o databases/mysql80-server:databases/mysql84-server
# pkg upgrade
20260325:
AFFECTS: users of math/coq
AUTHOR: jrm@FreeBSD.org
Upstream no longer installs Emacs lisp, so the Emacs flavors have been
removed. In order for a `pkg upgrade` to install new versions of coq,
any installed package for a non-default flavor must be renamed. Do
this by running the commands below under /bin/sh with superuser
privileges:
on=$(pkg query -g %n coq-emacs_*)
nn=$(pkg query -g %n g coq-emacs_* | sed -e 's/-emacs_[a-z_]*//')
pkg set -n "$on":"$nn"
20260304:
AFFECTS: users of net-mgmt/netbox
AUTHOR: kai@FreeBSD.org
1. With the NetBox 4.5 release Python 3.10 and 3.11 are officially no
longer supported. The whole code can still be compiled without any
problems using Python 3.11, which is the current default version in
the ports tree.
Therefore, the minimum version for Python doesn't need to be raised
for the time being, but this may change at any time as soon as
backward-incompatible changes to the code lands into upstream for the
next release.
Thus, no further action is required at this time. However, it's still
recommended to switch to Python 3.12 or newer in the near future.
2. Please also check the pkg-message and the changelogs for further info.
20260325:
AFFECTS: Users of net-mgmt/ping_exporter
AUTHOR: ivy@FreeBSD.org
The format of ping_exporter's configuration file has changed.
Refer to https://github.com/czerwonk/ping_exporter/releases/tag/v1.2.0
for upstream documentation on how to migrate.
20260301:
AFFECTS: users of databases/postgresql* and other software using PostgreSQL to run
AUTHOR: kbowling@FreeBSD.org
The default version of PostgreSQL has been switched from 17 to 18.
The upgrade procedure can use up twice the space the databases
currently needs. If you have a big amount of stored data take a
closer look at the manpage of pg_upgrade for avoidance and/or
speedup of the upgrade.
The upgrade instructions consider a basic usage and do not match
complex scenarios like replication, sharding, or similar.
Upgrade instructions:
First stop your PostgreSQL, create PostgreSQL-binaries and backup your data.
If you have another Version of PostgreSQL installed, for example 17, your
files are named according to this.
# service postgresql stop
# pkg create postgresql17-server postgresql17-contrib
# mkdir /tmp/pg-upgrade
# tar xf postgresql17-server-17.9.pkg -C /tmp/pg-upgrade
# tar xf postgresql17-contrib-17.9.pkg -C /tmp/pg-upgrade
# pkg delete -f databases/postgresql17-server databases/postgresql17-contrib databases/postgresql17-client
Now update PostgreSQL:
pkg user:
# pkg install databases/postgresql18-server databases/postgresql18-contrib
# pkg upgrade
Portmaster users:
# portmaster databases/postgresql18-server databases/postgresql18-contrib
# portmaster -a
Portupgrade users:
# portinstall databases/postgresql18-server databases/postgresql18-contrib
# portupgrade -a
After installing the new PostgreSQL version you need to convert
all your databases to new version:
# su -l postgres -c "/usr/local/bin/initdb --encoding=utf-8 --lc-collate=C --no-data-checksums -D /var/db/postgres/data18 -U postgres"
# su -l postgres -c "pg_upgrade -b /tmp/pg-upgrade/usr/local/bin/ -d /var/db/postgres/data17/ -B /usr/local/bin/ -D /var/db/postgres/data18/ -U postgres "
Now the migration is finished. You can start PostgreSQL again with:
# service postgresql start
ATTENTION:
1) If you use non-default initdb options, you have to adjust the initdb-command accordingly
2) The initdb in the upgrade procedure uses '--no-data-checksums' to enable
pg_upgrade from before this change. You should review the documentation and
decide whether you want to then enable checksums with pg_checksums. Future
upgrade instructions for PostgreSQL 19 and later will assume a default
initdb, and therefore that checksums are enabled.
20260226:
AFFECTS: users of sysutils/symon
AUTHOR: jamie@catflap.org
The old WITHOUT_SYMON and WITHOUT_SYMUX knobs have been replaced with the
port options SYMON and SYMUX. The legacy "WITHOUT_RRD" knob has been retired.
20260226:
AFFECTS: users of java/openjdk*
AUTHOR: ronald@FreeBSD.org
Version JAVA_DEFAULT is updated from 8 to 21.
No specific action should be needed, just a heads-up to test before
deploying to production as this is quite a big step in versions.
20260225:
AFFECTS: users of net-im/gotosocial
AUTHOR: tilde@ultros.pro
net-im/gotosocial has been updated to 0.21.0
New configuration options have been added and the upgrade involves
lengthy database migrations which must not be interrupted.
Upgrade procedure:
1. # service gotosocial stop
2. Backup database
3. # pkg upgrade gotosocial
4. Merge new options from etc/gotosocial/config.yaml.sample
5. # service gotosocial start (do not interrupt database migrations!)
See details at https://codeberg.org/superseriousbusiness/gotosocial/releases/tag/v0.21.0
20260206:
AFFECTS: users of devel/freebsd-git-devtools
AUTHOR: jrm@FreeBSD.org
To improve discoverability with pkg search, devel/freebsd-git-devtools
has been split into devel/freebsd-git-arc and devel/mfc-candidates.
To remove the old package and install the new ones, use:
# pkg install freebsd-git-arc mfc-candidates
20260202:
AFFECTS: users of www/bluefish
AUTHOR: eduardo@FreeBSD.org
www/bluefish has been updated to 2.4.0.
Starting from 2.4 Bluefish will place config files no longer in
~/.bluefish. On FreeBSD it will be ~/.config and ~/.local/
See details at https://sourceforge.net/p/bluefish/code/HEAD/tree/tags/bluefish_2_4_0/ChangeLog
20260125:
AFFECTS: users of dns/ddclient
AUTHOR: mjl@luckie.org.nz
dns/ddclient has been updated to v4.0.0.
This release moves the default configuration file location from
/usr/local/etc/ to /usr/local/etc/ddclient/. Please move your
existing ddclient.conf to the new location before restarting ddclient.
See details at https://github.com/ddclient/ddclient/releases/tag/v4.0.0
20260115:
AFFECTS: users of lang/cython* and USE_PYTHON=cython*
AUTHOR: sunpoet@FreeBSD.org
lang/cython has been updated to 3.2.4.
To support ports that still require the legacy 0.x branch, lang/cython0
has been added (version 0.29.37). lang/cython3 has been removed as it
is now redundant with lang/cython.
Port maintainers should note the following changes:
- Ports requiring Cython 0.x now use USE_PYTHON=cython0{,_run}.
- Ports previously using cython3{,_run,_test} now use
USE_PYTHON=cython{,_run,_test}.
20260109:
AFFECTS: users of net-mgmt/librenms
AUTHOR: dvl@FreeBSD.org
mysql-client is no longer a dependency. This allows users to select
mysql or mariadb at run time. This was not possible before.
20260103:
AFFECTS: users of x11/nvidia-{driver, kmod}-devel variants
AUTHOR: junchoon@dec.sakura.ne.jp
x11/nvidia-driver-devel and x11/nvidia-kmod-devel are upgraded to
latest New Feature Branch [NFB] of upstream driver package.
This version drops support for a bunch of old (pre-Turing generations
of architecture) GPUs.
You can find still supported GPUs below.
https://us.download.nvidia.com/XFree86/FreeBSD-x86_64/590.48.01/README/supportedchips.html
So anyone using -devel variants of related ports
x11/nvidia-kmod-devel
x11/nvidia-driver-devel
graphics/nvidia-drm-{510|515|61|66|latest}-kmod-devel
x11/linux-nvidia-libs-devel
with dropped GPUs needs to switch to non-devel master ports.
x11/nvidia-kmod
x11/nvidia-driver
graphics/nvidia-drm-{510|515|61|66|latest}-kmod
x11/linux-nvidia-libs
Deinstalling -devel variants above and reinstalling master ports
above would do the right things.
If any of above hesitates to upgrade with version conflicts
of graphics/eglexternalplatform, upgrade it first and retrying
failed ones should help.
At the same time, 580.* and 590.* series of drivers for FreeBSD
now work with 2 additional libraries installed via graphics/egl-x11.
This is now one of the dependencies of x11/nvidia-driver{-devel}.
It would be automatically pulled in on upgrades.
Note that new legacy branch -580 would be created once Production
Branch of upstream driver package switches to 590 series or later.
20251228:
AFFECTS: users of net/rsync
AUTHOR: rodrigo@FreeBSD.org
Add a new option PYTHON that controls when the Python script
sbin/rrsync is installed and adds the necessary dependencies.
By default this option is off; updating the package will remove
the rrsync script.
20251208:
AFFECTS: users of net-mgmt/unifi{9,10}
AUTHOR: otis@FreeBSD.org
Version 10 of UniFi controller has been introduced, conflicting with
version 9.
Users are strongly advised to make a fresh backup of UniFi controller
database from within the UI, prior to upgrade to unifi10.
20251201:
AFFECTS: users of lang/php83
AUTHOR: bofh@FreeBSD.org
The default version of PHP has been switched from 8.3 to 8.4.
If you use binary packages you should make a list of php packages
before running 'pkg upgrade':
# pkg info \*php83\* > ~/installed-php-ports-list
After the upgrade, check with such list if all your php extensions
are still installed, and reinstall them if needed.
If you use mod_php83 you need to deinstall it and install mod_php84.
20251201:
AFFECTS: users of sysutils/tmux
AUTHOR: jrm@FreeBSD.org
tmux must be restarted after upgrading. This is particularly
important with version 3.6 because one of the libraries that tmux uses
has changed its protocol. If you see the following message when you
try to attach, it likely means you forgot to restart tmux:
open terminal failed: not a terminal
20251130:
AFFECTS: users of www/node{22,24,25}
AUTHOR: sunpoet@FreeBSD.org
www/node{22,24,25} now uses databases/sqlite3 instead of the bundled one.
It requires SESSION option (enabled by default) in databases/sqlite3.
Please update your option configuration. Otherwise, the build fails.
See PR 290509 and 290588 for details.
20251113:
AFFECTS: users of deskutils/fet
AUTHOR: uzsolt@FreeBSD.org
Remove Qt flavors, only use Qt6.
You should uninstall the flavored package and install the unflavored package.
20251105:
AFFECTS: users of net/unison
AUTHOR: madpilot@FreeBSD.org
With the update to version 2.53.8 the port uses upstream install target.
This causes the installed unison binary to always be the command line
version, even when the port is compiled with xorg support. The UI binary
is installed as unison-gui.
The unison.desktop file provided with the port is adjusted to launch the
new unison-gui binary.
Please verify any local scripts using the unison binaries are adapted to
this change.
20251019:
AFFECTS: users of security/clamav
AUTHOR: yasu@FreeBSD.org
After security/clamav is updated to 1.5.0, some users report that build
fails as below.
/usr/ports/security/clamav/work/clamav-1.5.1/libclamav/others.c:623:23: error: use of undeclared identifier 'CERTSDIR'
623 | cvdcertsdir = CERTSDIR;
| ^
1 warning and 1 error generated.
ninja: build stopped: subcommand failed.
*** Error code 1
The error seems to happen with following conditions.
* Non-base SSL stack is used. That is, in /etc/make.conf there is such
setting as 'DEFAULT_VERSIONS+=ssl=openssl'.
* Previous version (1.4.3) of clamav package is already installed.
If you face it, you can work around it by uninstalling current clamav
package first.
20251016:
AFFECTS: users of devel/nexus2-oss
AUTHOR: michaelo@FreeBSD.org
With the upgrade to javaservicewrapper-3.6.3 Nexus won't start unless you
remove all properties ending with '.stripquotes' in your
%%ETCDIR%%/wrapper.conf.
20251016:
AFFECTS: users of sysutils/javaservicewrapper
AUTHOR: michaelo@FreeBSD.org
With the upgrade to version 3.6.0+ support for all properties ending with
'.stripquotes' in your wrapper.conf has been dropped and your application
won't start again.
Read the release notes for more details:
https://wrapper.tanukisoftware.com/doc/english/release-notes.html#3.6.0
20251015:
AFFECTS: users of security/libressl
AUTHOR: brnrd@FreeBSD.org
The port has been updated to the latest stable version 4.2 of LibreSSL.
The shared library versions of the libraries have been bumped.
After upgrading, manually update all packages that depend on any of the
libraries provided by LibreSSL (libssl, libcrypto and libtls) since the
versions of these libraries have changed. Normally, you can obtain the
list of dependent software by running the following command:
# pkg info -r libressl
Then you should rebuild all ports depending on libressl to avoid dangling
shared library dependencies.
20251011:
AFFECTS: users of net-im/gotosocial
AUTHOR: dinoex@FreeBSD.org
The etc/gotosocial/config.yaml file needs to be edited.
Also includes breaking changes to prometheus metrics.
See release notes for details:
https://codeberg.org/superseriousbusiness/gotosocial/releases/tag/v0.20.0
Requires a lengthy database migration which must not be interrupted!
20250930:
AFFECTS: users of x11/nvidia-driver*
AUTHOR: junchoon@dec.sakura.ne.jp
Because of splitting out kernel modules (kmod) part from x11/nvidia-driver*
into newly introduced x11/nvidia-kmod*, you need to deinstall currently
installed x11/nvidia-driver* and freshly install it again with new version.
This would pull in corresponding x11/nvidia-kmod* because x11/nvidia-driver*
explicitly depends on corresponding x11/nvidia-kmod*.
20250918:
AFFECTS: users of sysutils/py-mitogen
AUTHOR: dch@FreeBSD.org
Ansible 12 is soft deprecating the ANSIBLE_STRATEGY functionality that
mitogen uses to integrate with Ansible. A future version of ansible-core
may remove this. See https://github.com/mitogen-hq/mitogen/issues/1278
20250917:
AFFECTS: users of mail/pflogsumm
AUTHOR: flo@FreeBSD.org
Some command line arguments were renamed in 1.1.11 and 1.1.12.
For details, see https://jimsun.linxnet.com/downloads/ChangeLog-1.1.12
20250908:
AFFECTS: users of www/mod_wsgi4
AUTHOR: michaelo@FreeBSD.org
This port has been renamed to www/mod_wsgi to be able to upgrade to
version 5.
20250828:
AFFECTS: users of databases/mongodb70, databases/mongodb80
AUTHOR: ronald@FreeBSD.org
Ports mongodb70 7.0.23 and mongodb80 since 8.0.0 contain a patch to
implement waitable atomics for FreeBSD.
This patch is developed by me. It did not go through QA of MongoDB Inc.
I don't have full QA in place and could only do limited testing. I
can't take any responsibility for the quality of the patch.
Make backups and test for yourself in your setup before upgrading
any critical production environment.
20250817:
AFFECTS: users of lang/perl5.*
AUTHOR: mat@FreeBSD.org
The default Perl version has been switched to 5.42.
See entry 20231017 for updating instructions.
20250815:
AFFECTS: users of net/syncthing
AUTHOR: dvl@FreeBSD.org
Old single-dash long options are no longer supported, e.g. -home must be
given as --home. Database backend switched from LevelDB to SQLite. No
changes to run-time dependencies. There is a migration on first launch
which can be lengthy for larger setups.
More at https://github.com/syncthing/syncthing/releases/tag/v2.0.0
20250804:
AFFECTS: users of databases/adminer
AUTHOR: pkaipila@gmail.com
Flavors have been added to the adminer port. Due to the change in PKGNAME,
pkg will not notice the update. Replace the package with a flavored one
such as php84-adminer.
20250728:
AFFECTS: users of www/privatebin
AUTHOR: dvl@FreeBSD.org
This release changes configuration defaults including switching the template
and removing legacy features.
See details at https://github.com/PrivateBin/PrivateBin/releases/tag/2.0.0
20250720:
AFFECTS: users of www/phpmyfaq
AUTHOR: flo@FreeBSD.org
Upgrading from 3.2.x is a major upgrade. Your existing templates will not
work with phpMyFAQ 4.0. Please make a full backup before you run the
upgrade! First, log in as admin into the admin section and enable the
maintenance mode. (Configuration >> Edit Configuration >> Set FAQ in
maintenance mode) Second, you have to delete all files except:
in the directory config/
keep the file database.php
only if using LDAP/ActiveDirectory support also keep the file ldap.php
only if using EntraID support also keep the file azure.php
the directory attachments/
the directory data/
the directory images/
Install the new version then open the following URL in your browser:
https://www.example.com/faq/update
Click the button of the update script, your version will automatically be updated.
20250709:
AFFECTS: users of sysutils/bastille
AUTHOR: jdhurtado@orbiware.com
Potentially breaking changes since 1.0.20250714
Network: Bastille now handles all epairs dynamically, allowing both -V and -B
VNET jails to coexist. Previous versions only supported one type per system.
New naming scheme for network interfaces is e0a_jailname (host side) and
e0b_jailname (jail side). Additional interfaces: e1a_jailname, e1b_jailname, etc
(incrementing numbers). Long jail names are truncated with xx placeholder due to
interface name limitations
Required action after update: