git: 56d55c92b9 - main - handbook/ports: file:// URLs for poudriere repos

From: Graham Perrin <grahamperrin_at_FreeBSD.org>
Date: Fri, 05 May 2023 17:41:38 UTC
The branch main has been updated by grahamperrin:

URL: https://cgit.FreeBSD.org/doc/commit/?id=56d55c92b940c9755f8aba81f9253b93c238a8c1

commit 56d55c92b940c9755f8aba81f9253b93c238a8c1
Author:     Jonathan Vasquez <jon@xyinn.org>
AuthorDate: 2022-05-13 18:00:14 +0000
Commit:     Graham Perrin <grahamperrin@FreeBSD.org>
CommitDate: 2023-05-05 17:28:17 +0000

    handbook/ports: file:// URLs for poudriere repos
    
    FreeBSD Handbook: …: Configuring pkg Clients to Use a Poudriere
    Repository
    
    Add a small section showing the user how to point to their packages
    repository (package directory in this case) via file://. Allow the user
    to not publicly expose their packages over the Internet.
    
    https://bugs.freebsd.org/263955
    
    PR:                      263955
    Reported by:             Jonathan Vasquez
    Reviewed by:             debdrup, pauamma
    Pull request:            https://github.com/freebsd/freebsd-doc/pull/66
---
 documentation/content/en/books/handbook/ports/_index.adoc | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/documentation/content/en/books/handbook/ports/_index.adoc b/documentation/content/en/books/handbook/ports/_index.adoc
index 39a6d8173a..4690379e63 100644
--- a/documentation/content/en/books/handbook/ports/_index.adoc
+++ b/documentation/content/en/books/handbook/ports/_index.adoc
@@ -1285,6 +1285,16 @@ custom: {
 }
 ....
 
+If exposing the package repository to the internet is not desired, the `file://` protocol can be used to point to the repository directly:
+
+[.programlisting]
+....
+custom: {
+	url: "file:///usr/local/poudriere/data/packages/11amd64",
+	enabled: yes,
+}
+....
+
 [[ports-nextsteps]]
 == Post-Installation Considerations