Skip to content

Commit eabc5dc

Browse files
committed
update freebsd docs
1 parent bcf3be5 commit eabc5dc

2 files changed

Lines changed: 13 additions & 146 deletions

File tree

source/installation.rst

Lines changed: 13 additions & 77 deletions
Original file line numberDiff line numberDiff line change
@@ -1406,85 +1406,18 @@ Community Repositories
14061406
14071407
.. tab:: FreeBSD
14081408

1409-
To install Unit from
1410-
`FreeBSD packages
1411-
<https://docs.freebsd.org/en/books/handbook/ports/#pkgng-intro>`_,
1409+
To install
1410+
`FreeUnit
1411+
<https://www.freshports.org/www/freeunit/>`_,
14121412
get the core package and other packages you need:
14131413

14141414
.. code-block:: console
14151415
1416-
# pkg install -y unit
1416+
# pkg install -y freeunit
14171417
14181418
.. code-block:: console
14191419
1420-
# pkg install -y :nxt_hint:`libunit <Required to install the Node.js module>`
1421-
1422-
.. code-block:: console
1423-
1424-
# pkg install -y unit-java8 \
1425-
unit-perl5.36 \
1426-
unit-php81 unit-php82 unit-php83 \
1427-
unit-python39 \
1428-
unit-ruby3.2 \
1429-
unit-wasm
1430-
1431-
.. code-block:: console
1432-
1433-
# service unitd restart # Necessary for Unit to pick up any changes in language module setup
1434-
1435-
To install Unit from
1436-
`FreeBSD ports
1437-
<https://docs.freebsd.org/en/books/handbook/ports/#ports-using>`_,
1438-
start by updating your port collection.
1439-
1440-
With :program:`portsnap`:
1441-
1442-
.. code-block:: console
1443-
1444-
# portsnap fetch update
1445-
1446-
With :program:`git`:
1447-
1448-
.. code-block:: console
1449-
1450-
# cd /usr/ports && git pull
1451-
1452-
Next, browse to the port path
1453-
to build and install the core Unit port:
1454-
1455-
.. code-block:: console
1456-
1457-
# cd /usr/ports/www/unit/
1458-
1459-
.. code-block:: console
1460-
1461-
# make
1462-
1463-
.. code-block:: console
1464-
1465-
# make install
1466-
1467-
Repeat the steps for the other ports you need:
1468-
`libunit
1469-
<https://www.freshports.org/devel/libunit/>`_
1470-
(required to install the Node.js
1471-
:ref:`module <installation-nodejs-package>`
1472-
and build
1473-
:ref:`Go apps <configuration-go>`),
1474-
`unit-java
1475-
<https://www.freshports.org/www/unit-java/>`__,
1476-
`unit-perl
1477-
<https://www.freshports.org/www/unit-perl/>`__,
1478-
`unit-php
1479-
<https://www.freshports.org/www/unit-php/>`__,
1480-
`unit-python
1481-
<https://www.freshports.org/www/unit-python/>`__,
1482-
`unit-ruby
1483-
<https://www.freshports.org/www/unit-ruby/>`__,
1484-
or
1485-
`unit-wasm
1486-
<https://www.freshports.org/www/unit-wasm/>`__.
1487-
After that, restart Unit:
1420+
# pkg install -y freeunit-php85 freeunit-python312
14881421
14891422
.. code-block:: console
14901423
@@ -1494,31 +1427,34 @@ Community Repositories
14941427

14951428
.. list-table::
14961429

1430+
* - Rc script
1431+
- **/usr/local/etc/rc.d/unitd**
1432+
14971433
* - Control :ref:`socket <source-startup>`
14981434
- **/var/run/unit/control.unit.sock**
14991435

15001436
* - Log :ref:`file <troubleshooting-log>`
1501-
- **/var/log/unit/unit.log**
1437+
- **/var/log/freeunit/freeunit.log**
15021438

15031439
* - Non-privileged :ref:`user and group <security-apps>`
15041440
- **www**
15051441

15061442
* - Startup and shutdown
15071443
- .. code-block:: console
15081444

1509-
# :nxt_hint:`service unitd enable <Enable Unit to launch automatically at system startup>`
1445+
# :nxt_hint:`service unitd enable <Enable FreeUnit to launch automatically at system startup>`
15101446

15111447
.. code-block:: console
15121448
1513-
# :nxt_hint:`service unitd restart <Start or restart Unit; one-time action>`
1449+
# :nxt_hint:`service unitd restart <Start or restart FreeUnit; one-time action>`
15141450
15151451
.. code-block:: console
15161452
1517-
# :nxt_hint:`service unitd stop <Stop a running Unit; one-time action>`
1453+
# :nxt_hint:`service unitd stop <Stop a running FreeUnit; one-time action>`
15181454
15191455
.. code-block:: console
15201456
1521-
# :nxt_hint:`service unitd disable <Disable Unit's automatic startup>`
1457+
# :nxt_hint:`service unitd disable <Disable FreeUnit's automatic startup>`
15221458
15231459
15241460
.. tab:: Gentoo

source/migration.rst

Lines changed: 0 additions & 69 deletions
Original file line numberDiff line numberDiff line change
@@ -262,69 +262,6 @@ The rebase is mechanical:
262262
* - Non-privileged :ref:`user and group`
263263
- **nobody**
264264

265-
.. tab:: FreeBSD
266-
267-
Recipe: the ``www/unit`` port in
268-
`freebsd/freebsd-ports
269-
<https://cgit.freebsd.org/ports/tree/www/unit>`_.
270-
271-
Strategy: create a new slave-free port ``www/freeunit`` and mark the
272-
old ``www/unit`` port deprecated with ``MOVED`` redirect.
273-
274-
#. **Copy the port tree**
275-
276-
.. code-block:: console
277-
278-
$ cp -R www/unit www/freeunit
279-
$ cp -R www/unit-php www/freeunit-php
280-
$ cp -R www/unit-python www/freeunit-python
281-
# …repeat for perl, ruby, wasm, libunit → libfreeunit
282-
283-
#. **Update each Makefile**
284-
285-
.. code-block:: make
286-
:caption: www/freeunit/Makefile
287-
288-
PORTNAME= freeunit
289-
DISTVERSION= 1.35.3
290-
CATEGORIES= www
291-
MAINTAINER= you@example.org
292-
COMMENT= Dynamic application server, community LTS fork of NGINX Unit
293-
294-
USE_GITHUB= yes
295-
GH_ACCOUNT= freeunitorg
296-
GH_PROJECT= freeunit
297-
298-
CONFLICTS_INSTALL= unit-[0-9]* unit-php-[0-9]* unit-python-[0-9]* unit-perl-[0-9]* unit-ruby-[0-9]* unit-wasm-[0-9]*
299-
300-
#. **Regenerate distinfo**
301-
302-
.. code-block:: console
303-
304-
$ make makesum
305-
306-
#. **Register the rename in ``MOVED``**
307-
308-
.. code-block:: text
309-
310-
www/unit|www/freeunit|2026-04-19|Project renamed to FreeUnit
311-
312-
#. **Test-build via poudriere, then submit a PR** to
313-
`freebsd-ports <https://github.com/freebsd/freebsd-ports>`_.
314-
315-
Runtime details (unchanged from the legacy ``www/unit`` port):
316-
317-
.. list-table::
318-
319-
* - Control :ref:`socket`
320-
- **/var/run/unit/control.unit.sock**
321-
322-
* - Log :ref:`file`
323-
- **/var/log/unit/unit.log**
324-
325-
* - Non-privileged :ref:`user and group`
326-
- **www**
327-
328265
.. tab:: Gentoo
329266

330267
Recipe: ``www-servers/nginx-unit`` in the
@@ -1052,12 +989,6 @@ If you need to revert to the previous setup:
1052989
1053990
$ yay -S unit
1054991
1055-
.. tab:: FreeBSD
1056-
1057-
.. code-block:: console
1058-
1059-
# pkg install unit
1060-
1061992
.. tab:: Gentoo
1062993

1063994
.. code-block:: console

0 commit comments

Comments
 (0)