Bug 287719 - bsdinstall: Inaccurate message points to stale wiki page
Summary: bsdinstall: Inaccurate message points to stale wiki page
Status: Closed FIXED
Alias: None
Product: Base System
Classification: Unclassified
Component: bin (show other bugs)
Version: 15.0-CURRENT
Hardware: Any Any
: --- Affects Many People
Assignee: Alexander Ziaee
URL: https://github.com/freebsd/freebsd-sr...
Keywords: install
Depends on:
Blocks:
 
Reported: 2025-06-22 12:10 UTC by devnull
Modified: 2026-08-06 22:41 UTC (History)
3 users (show)

See Also:


Attachments
Screenshot: the partitioning dialogue with FreeBSD-15.0-CURRENT-amd64-20250621-eb5884c564ae-278132-disc1.iso (9.60 KB, image/png)
2025-06-22 12:10 UTC, devnull
no flags Details
Screenshot: 14.3-RELEASE, minimal, UFS, pkg killed during pkgbasify (27.44 KB, image/png)
2025-06-23 20:47 UTC, devnull
no flags Details
Screenshot from comment 7 (26.32 KB, image/png)
2026-02-04 00:40 UTC, devnull
no flags Details

Note You need to log in before you can comment on or make changes to this bug.
Description devnull freebsd_committer freebsd_triage 2025-06-22 12:10:15 UTC
Created attachment 261478 [details]
Screenshot: the partitioning dialogue with FreeBSD-15.0-CURRENT-amd64-20250621-eb5884c564ae-278132-disc1.iso

base eb5884c564ae (2025-06-20) recommends at least 256 MiB, if the system has insufficient memory. 

256 MB may be insufficient for a minimal set of 284 base packages, please see <https://www.reddit.com/r/freebsd/comments/1lcm1ze/comment/mz4y0fr/>. 

base 595373dd646b (2020-01-27) added a contextual footer to the partitioning dialogue: 

> To use ZFS with less than 8GB RAM, see 
> https://wiki.freebsd.org/ZFSTuningGuide

– that page was marked as stale in 2022.  

doc e1ecde315c98 (2023-01-12) removed a recommendation with regard to general purpose desktop systems: 

> 2-4 GB RAM

Since then, as far as I can tell, neither the Project site nor the documentation portal describes hardware requirements or system requirements.

Focusing on the installer
=========================

A) maybe review the 256 MiB recommendation before 15.0-RELEASE

B) consider adding a complementary warning, targeting laptop/desktop 
   use cases, when the installer runs on a system with less than … 
   maybe 6 GB memory.
Comment 1 Alexander Ziaee freebsd_committer freebsd_triage 2025-06-22 15:02:12 UTC
The 256MiB minimum was just reviewed with last week's CURRENT when that commit went in. For additional info, as it says in the commit you linked, pkgbase is what requires 256MiB. As it says in the Reddit thread you linked, we have users running FreeBSD on <100MiB of RAM, and it can be tweaked much farther than that.

Desktop is just one of many third party applications which requires additional RAM over the minimum. Believe it or not, embedded is a massively more popular use-case than desktop. We are also supporting use-cases which really require TBs of RAM.

The ZFS requirements were due to a bug in our previous ZFS implementation, which is why that recommendation was removed. I have a machine with two pools and over 4TB of disks which has been running on 4GB RAM with zero problems for a few years. Still, UFS is much simpler and thus recommended for resource constrained applications.

As for the desktop recommendation, there are more than a few desktops in the wild from people who strip adverts from the web who are happy with 1Gb ram, and there are people who video conference while doing other things and organize their browser tabs that are not happy with 16Gb ram.
Comment 2 devnull freebsd_committer freebsd_triage 2025-06-22 15:21:23 UTC
> A) maybe review the 256 MiB recommendation before 15.0-RELEASE
Comment 3 devnull freebsd_committer freebsd_triage 2025-06-22 15:40:24 UTC
Also, before a second closure, note that it's not appropriate for bsdinstall to misdirect readers to a stale page with such outdated content. 

The attachment at comment 0 showed the bugged dialogue.
Comment 4 Alexander Ziaee freebsd_committer freebsd_triage 2025-06-22 17:47:45 UTC
OK, that isn't what you said that this bug says is about, but that is a good catch, and I do appreciate that. https://reviews.freebsd.org/D50971 . Thanks.
Comment 5 devnull freebsd_committer freebsd_triage 2025-06-22 19:06:42 UTC
For logged out users, who do not see the original title: 

bsdinstall: system requirements: memory/RAM: UFS and ZFS
Comment 6 Ed Maste freebsd_committer freebsd_triage 2025-06-23 15:36:02 UTC
Note that debugging options in main (that will be disabled for 15.0) may have an effect on memory use. We can increase the 256 MiB suggestion before 15.0 releases, if necessary.

I added the warning to the installer based on:
- QEMU's default is 128 MiB
- the installer reliably OOMs with 128 MiB
- I was able to install a minimal system for testing with 256 MiB, UFS root fs
Comment 7 devnull freebsd_committer freebsd_triage 2025-06-23 20:47:12 UTC
Created attachment 261517 [details]
Screenshot: 14.3-RELEASE, minimal, UFS, pkg killed during pkgbasify

(In reply to Ed Maste from comment #6)

> - I was able to install a minimal system for testing with 256 MiB, UFS root fs

I can do similar, 14.3-RELEASE in a VirtualBox guest, then before exiting the installer: 

<https://imgur.com/FfsMYeS>

– a first run of pkgbasify ended with pkg 2.2.0 killed at step 20 of 268.
Comment 8 devnull freebsd_committer freebsd_triage 2026-02-04 00:40:47 UTC
Created attachment 267757 [details]
Screenshot from comment 7

Re: comment 7

> <https://imgur.com/FfsMYeS>

Attaching the screenshot, because access to Imgur from the United Kingdom is no longer available. 

<https://help.imgur.com/hc/en-us/articles/41592665292443-Imgur-access-in-the-United-Kingdom>
Comment 9 devnull freebsd_committer freebsd_triage 2026-02-04 01:32:03 UTC
Re: comment #6

From <https://mastodon.bsd.cafe/@grahamperrin/116009730031955323>: 

> … failure to install offline packages – packages are the default with 
> FreeBSD-15.0-RELEASE-amd64-dvd1.iso – with UFS, vm.pageout_oom_seq=120 
> and 256 MB given to a VirtualBox guest. …

…
Feb  4 01:05:58  pkg[1652]: FreeBSD-bzip2-lib32-15.0 installed
Feb  4 01:05:58  pkg[1652]: FreeBSD-ccdconfig-15.0 installed
Feb  4 01:05:58  pkg[1652]: FreeBSD-clibs-15.0 installed
Feb  4 01:06:50  kernel: pid 1652 (pkg), jid 0, uid 0, was killed: failed to reclaim memory
…
Comment 10 commit-hook freebsd_committer freebsd_triage 2026-04-28 17:02:56 UTC
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/src/commit/?id=5ed26c21e4ff1d478d4611abbf3dc14cc1b77244

commit 5ed26c21e4ff1d478d4611abbf3dc14cc1b77244
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2026-04-28 16:59:19 +0000
Commit:     Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2026-04-28 16:59:34 +0000

    bsdinstall: Improve auto-partition message

    Manually tuning ZFS for systems with <8GB ram hasn't been necessary at
    least since the switch to OpenZFS. We have users reporting using 1GB RAM
    with no manual tuning/issues. Further, the page this links to is a stale
    wiki page, which is causing complaints. Remove this misleading note and
    replace it with a similar message for UFS. While here, reword that note
    to be a bit clearer.

    PR:                     287719
    MFC after:              3 days
    Differential Revision:  https://reviews.freebsd.org/D50971

 usr.sbin/bsdinstall/scripts/auto | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
Comment 11 commit-hook freebsd_committer freebsd_triage 2026-05-01 15:13:33 UTC
A commit in branch stable/15 references this bug:

URL: https://cgit.FreeBSD.org/src/commit/?id=5702d242429f1f791e05a720a9a411b1e64212dc

commit 5702d242429f1f791e05a720a9a411b1e64212dc
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2026-04-28 16:59:19 +0000
Commit:     Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2026-05-01 15:13:02 +0000

    bsdinstall: Improve auto-partition message

    Manually tuning ZFS for systems with <8GB ram hasn't been necessary at
    least since the switch to OpenZFS. We have users reporting using 1GB RAM
    with no manual tuning/issues. Further, the page this links to is a stale
    wiki page, which is causing complaints. Remove this misleading note and
    replace it with a similar message for UFS. While here, reword that note
    to be a bit clearer.

    PR:                     287719
    MFC after:              3 days
    Differential Revision:  https://reviews.freebsd.org/D50971

    (cherry picked from commit 5ed26c21e4ff1d478d4611abbf3dc14cc1b77244)

 usr.sbin/bsdinstall/scripts/auto | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
Comment 12 commit-hook freebsd_committer freebsd_triage 2026-05-07 22:18:27 UTC
A commit in branch releng/15.1 references this bug:

URL: https://cgit.FreeBSD.org/src/commit/?id=bf5ca5ced57d615093056e7f8013497b0fe4068f

commit bf5ca5ced57d615093056e7f8013497b0fe4068f
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2026-04-28 16:59:19 +0000
Commit:     Colin Percival <cperciva@FreeBSD.org>
CommitDate: 2026-05-07 22:16:32 +0000

    bsdinstall: Improve auto-partition message

    Manually tuning ZFS for systems with <8GB ram hasn't been necessary at
    least since the switch to OpenZFS. We have users reporting using 1GB RAM
    with no manual tuning/issues. Further, the page this links to is a stale
    wiki page, which is causing complaints. Remove this misleading note and
    replace it with a similar message for UFS. While here, reword that note
    to be a bit clearer.

    Approved by:    re (cperciva)
    PR:                     287719
    MFC after:              3 days
    Differential Revision:  https://reviews.freebsd.org/D50971

    (cherry picked from commit 5ed26c21e4ff1d478d4611abbf3dc14cc1b77244)
    (cherry picked from commit 5702d242429f1f791e05a720a9a411b1e64212dc)

 usr.sbin/bsdinstall/scripts/auto | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
Comment 13 commit-hook freebsd_committer freebsd_triage 2026-08-06 22:33:11 UTC
A commit in branch stable/14 references this bug:

URL: https://cgit.FreeBSD.org/src/commit/?id=b2e845c577de15e29d9a635dea839da3c1687276

commit b2e845c577de15e29d9a635dea839da3c1687276
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2026-04-28 16:59:19 +0000
Commit:     Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2026-08-06 22:27:19 +0000

    bsdinstall: Improve auto-partition message

    Manually tuning ZFS for systems with <8GB ram hasn't been necessary at
    least since the switch to OpenZFS. We have users reporting using 1GB RAM
    with no manual tuning/issues. Further, the page this links to is a stale
    wiki page, which is causing complaints. Remove this misleading note and
    replace it with a similar message for UFS. While here, reword that note
    to be a bit clearer.

    PR:                     287719
    MFC after:              3 days
    Differential Revision:  https://reviews.freebsd.org/D50971

    (cherry picked from commit 5ed26c21e4ff1d478d4611abbf3dc14cc1b77244)

 usr.sbin/bsdinstall/scripts/auto | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)