FreeBSD Installation

FreeBSD 14.0+ using pkg utility.

System packages

• sudo pkg update
• sudo pkg install -y git gmake cmake wget pkgconf perl5 p5-App-cpanminus
• sudo pkg install -y webp giflib jpeg-turbo png tiff libheif ImageMagick7 librsvg2 pngquant
• sudo pkg install -y postgresql18-server postgresql18-client redis
• sudo pkg install -y libargon2 e2fsprogs-libuuid texlive-base texlive-texmf
• sudo pkg install -y nginx apache24 xorriso cdrkit-genisoimage transmission-cli

Perl modules

Install modules:

• sudo cpanm Mojolicious EV Mojo::Pg Mojo::Redis DBD::Pg
• sudo cpanm GD Imager Imager::File::JPEG Imager::File::GIF Imager::File::PNG Imager::File::TIFF Imager::File::HEIF
• sudo cpanm Mojolicious::Plugin::LocaleTextDomainOO Locale::TextDomain::OO::Extract
• sudo cpanm Params::Classify Params::Util Params::Validate Crypt::Argon2 Crypt::PBKDF2 Crypt::Eksblowfish::Bcrypt CryptX Digest::SHA Digest::SHA1 App::bmkpasswd Bytes::Random::Secure::Tiny
• sudo cpanm Clone Data::UUID UUID DateTime DateTime::TimeZone Date::Calc Date::Format Hash::Merge
• sudo cpanm Text::MultiMarkdown MojoX::MIME::Types IO::Compress::Gzip YAML::XS
• sudo cpanm MIME::Base64 MIME::Lite MIME::Types File::Spec File::MimeInfo Time::HiRes
• sudo cpanm --force HTML::Parser
• sudo cpanm HTML::FormatText HTML::TreeBuilder Business::Tax::VAT::Validation
• sudo cpanm Session::Token Mojolicious::Plugin::Util::RandomString Mojolicious::Plugin::OAuth2 Crypt::OpenSSL::Bignum Crypt::OpenSSL::RSA Mojo::JWT
• sudo cpanm Mojolicious::Plugin::Captcha Mojolicious::Plugin::Mail Test::Harness
• sudo cpanm Net::DNS::Resolver Net::IP Net::IDN::Encode

Imager::File::WEBP installation

• cd /tmp
• fetch https://cpan.metacpan.org/authors/id/T/TO/TONYC/Imager-File-WEBP-0.005.tar.gz
• tar xzf Imager-File-WEBP-0.005.tar.gz
• cd Imager-File-WEBP-0.005
• perl -pi -e 's/libopts => "-lwebpmux -lwebp",/libopts => "-L\/usr\/local\/lib -lwebpmux -lwebp",/' Makefile.PL
• perl Makefile.PL --incpath=/usr/local/include --libpath=/usr/local/lib
• make
• make test
• sudo make install

Database

• sudo /usr/local/etc/rc.d/postgresql oneinitdb
• sudo sysrc postgresql_enable=YES redis_enable=YES
• sudo service postgresql start && sudo service redis start
• sudo -u postgres createuser -P samizdat
• sudo -u postgres createdb -O samizdat -E UTF-8 -T template0 --locale=en_US.UTF-8 samizdat

Edit /usr/local/pgsql/data/pg_hba.conf, add: local samizdat samizdat scram-sha-256

Then: sudo service postgresql restart

Application

• sudo mkdir -p /sites && cd /sites
• sudo git clone https://github.com/FAKEMedium/Samizdat.git && cd Samizdat
• sudo chown -R www:www /sites/Samizdat
• sudo -u www cp samizdat.dist.yml samizdat.yml && sudo -u www vi samizdat.yml
• sudo -u www gmake fetchall && sudo -u www bin/samizdat migrate && sudo -u www gmake i18n

Optional Webpack frontend:

• sudo pkg install -y node npm python3 vips

For single installation:

• sudo -u www gmake webpackinit
• sudo -u www env SHARP_FORCE_GLOBAL_LIBVIPS=1 gmake webpack

For multiple sites (shared node_modules):

System-wide (requires root):

• sudo mkdir -p /usr/local/share/samizdat && cd /usr/local/share/samizdat
• sudo cp /sites/Samizdat/package.json .
• sudo mkdir -p .npm-cache
• sudo env SHARP_FORCE_GLOBAL_LIBVIPS=1 HOME=/usr/local/share/samizdat npm_config_cache=/usr/local/share/samizdat/.npm-cache npm install

User-level (no root):

• mkdir -p ~/samizdat-shared && cd ~/samizdat-shared
• cp /sites/Samizdat/package.json .
• mkdir -p .npm-cache
• env SHARP_FORCE_GLOBAL_LIBVIPS=1 HOME=$(pwd) npm_config_cache=$(pwd)/.npm-cache npm install

Then in each site: gmake webpack (will auto-detect and link to shared node_modules)

Note: The SHARP_FORCE_GLOBAL_LIBVIPS=1 environment variable tells sharp to use the system-installed libvips instead of downloading prebuilt binaries, which are not available for BSD systems.

SSL cert (dev):

• sudo -u www gmake cert

Usage

• gmake debug - Dev server (https://localhost:3443)
• gmake serverstart/stop - Production
• gmake static_all/en/sv - Generate content cache
• gmake i18n test routes - Dev tasks
• gmake webpack - Build assets
• gmake iso - Build ISO file
• bin/samizdat migrate - DB migrations

Jails & Service

For jails: ensure network access, mount devfs, configure port forwarding.

Copy samizdat.rc to /usr/local/etc/rc.d/samizdat, then enable with: sudo chmod +x /usr/local/etc/rc.d/samizdat && sudo sysrc samizdat_enable=YES

Performance tuning in /etc/sysctl.conf:

• kern.maxfiles=100000
• kern.maxfilesperproc=50000
• net.inet.tcp.sendspace=65536
• net.inet.tcp.recvspace=65536