katie/continuwuity-bsd
1
0
Fork 0
Code Issues Pull requests Releases 4 Packages 2 Activity Actions
continuwuity-bsd/freebsd
History
Katie Kloss c4161e1e55
Some checks failed
Build FreeBSD package / build (haswell, 14) (push) Has been cancelled
Details
Build FreeBSD package / build (haswell, 15) (push) Has been cancelled
Details
Build FreeBSD package / build (generic, 14) (push) Has been cancelled
Details
Build FreeBSD package / build (generic, 15) (push) Has been cancelled
Details
docs: move FreeBSD docs to their own readme
2026-03-07 06:51:03 -05:00
..
files move Makefile over here 2026-02-24 16:31:12 -05:00
GIDs move Makefile over here 2026-02-24 16:31:12 -05:00
Makefile use LTO profile 2026-02-27 07:54:50 -05:00
pkg-descr move Makefile over here 2026-02-24 16:31:12 -05:00
README.md docs: move FreeBSD docs to their own readme 2026-03-07 06:51:03 -05:00
UIDs move Makefile over here 2026-02-24 16:31:12 -05:00

README.md

Continuwuity for FreeBSD

Installation instructions

I'm working on creating a package repository which can handle signing and automatic updates. In the meantime, the package can be installed manually:

  1. Download the latest package build for your FreeBSD version and architecture from the releases page. There are two variants each for FreeBSD 14 and 15:

    • generic: General-purpose build compatible with nearly all processors
    • haswell: Optimized1 build compatible with Intel Haswell-and-later and AMD Excavator-and-later processors (roughly 2014 and onward).

    Builds are currently available for AMD64 architectures only. ARM support is planned.

  2. Install the RocksDB package: 2

pkg install rocksdb
  1. Install the continuwuity package:
pkg add continuwuity-generic-0.5.5-freebsd15-amd64.pkg
  1. Enable the continuwuity service:
sysrc continuwuity_enable=YES

  1. Edit the continuwuity config file at /usr/local/etc/continuwuity/continuwuity.toml:

    • Set a server name using the server_name option
    • If your reverse proxy will run on another system, update the address option to listen on a non-loopback interface, e.g. address = ["0.0.0.0", "::"] to listen on all IPv4 and IPv6 addresses

  2. Configure your reverse proxy using the continuwuity docs.

  3. Start continuwuity and check its logs:

service continuwuity start
tail -f /var/log/daemon.log | grep continuwuity

Important

There's currently a bug that causes the terminal control characters for colors to appear in the log messages, which may obscure the first-run registration token.

In the message ...using the registration token ^[[1;32mLw8zPjL2fqb1clLq^[[0m, the registration token is actually Lw8zPjL2fqb1clLq (i.e. the portion between ^[[1;32m and ^[[0m)

  1. Specifically the AVX2 instruction set, which RocksDB can take advantage of. ↩︎

  2. The FreeBSD package is built against the latest version of rocksdb in the quarterly package repo. If you are using the latest repo instead, you may need to downgrade the package in order for continuwuity to run. ↩︎