This is an old revision of the document!
- freeBSD
- Jonathan Haack
- Haack's Networking
- netcmnd@jonathanhaack.com
#When installing, make sure to include “documentation” on text install screen. #After succesful install, run these commands first to get the ports installed
#If you did not do this, then for 10.X > freeBSD, bootstrap the entire system:
/usr/sbin/pkg
#With no internet, obtain the ports and migrate by disc to host, then:
cd /usr/ports/ports-mgmt/pkg make make install make clean
#If you have internet, but are running beneath 10.X and cannot bootstrap (above), then:
portsnap fetch
#Extract them into /usr/ports/ with the following
portsnap extract
#As of 10.X > freeBSD will automatically allow the native pkg manager to install ports: #This allows the user to avoid compiling from source and navigating to directories, e.g.:
pkg install <pkgname>
#You may still, however, compile the package from source #Just like the non-internet step installation of pkg requires above:
cd /usr/ports/<pkgname> make install make clean
#freeBSD has port managers, mostly that predate 10.X > freeBSD, but still help, such as:
pkg install portmaster
#And, notably, portupgrade listed below relies on Ruby, similar to Homebrew:
pkg install portupgrade
#Ok, this is a good time to:
reboot
#Then, probably get all your common packages:
pkg install cmus pkg install irssi pkg install lynx pkg install nano pkg install libreoffice pkg install gimp pkg install firefox pkg install chromium pkg install alpine pkg install mutt pkg install <lotsmore>
#Once nano, xorg, & mate-desktop are installed, set-up a “desktop” (GUI) such as: #KDE, Gnome, MATE, etc. Tap F1 at the log-in screen to toggle between
pkg install mate mate-desktop
#Desktops require “Window Managers” in order to function, such as: #Fluxbox, WindowMaker, X11, xwm, etc. - for ease, use xorg:
pkg install xorg
#You will need a way to switch between desktops, and one convenient package is:
pkg install slim
#Technically, that is all you need file-wise, but the /etc/ directory needs adjusting:
#Consider adjusting build release date for pkg
nano /etc/pkg/FreeBSD.conf
%Replace /latest with /release/0/ or whatever
#If you do that, then run these to update the package manager to that version:
pkg upgrade pkg update
#nano /etc/fstab #Add the following like below the last device (/dev):
proc /proc procfs rw 0 0
#Then, edit your rc.conf file:
dbus_enable="YES" hald_enable="YES" mate_enable="YES" slim_enable="YES"
#Or, add other desktops, ifconfigs, etc., such as:
kdm4_enable="YES"
#Next up, changing wireless settings, adding keys, etc., etc.
#Add to wheel and operator groups
#edit /etc/group
login root cd /etc nano group
#Once inside the editor nano, please edit the operator and wheel lines as follows:
operator:*:5:root,<username> wheel:*:0:root,<username>
#Or, edit the group file directly from the command line:
pw group mod <username> -m <username>
#To update freeBSD from the command line:
freebsd-update fetch freebsd-update install
#To upgrade to a specific distribution, for example, to 9.1 from 9.0:
freebsd-update -r 9.1-RELEASE upgrade freebsd-update install
#After either updating or installing a new release:
shutdown -r now
#After restarting, run the update again to remove old shared libraries and objects
freebsd-update install
Setting up dokuwiki on freeBSD and securing data directory (required on BSD). (Only making BSD specific permission changes at present.)
su - root cd /usr/ports/www/dokuwiki make install clean mv /usr/local/www/dokuwiki /usr/local/www/nginx/dokuwiki sudo chown -R www /usr/local/www/nginx/dokuwiki/conf sudo chown www /usr/local/www/nginx/dokuwiki/data sudo chmod -R 775 /usr/local/www/nginx/dokuwiki/data sudo chmod -R 755 /usr/local/www/nginx/dokuwiki/lib sudo chmod -R 755 /usr/local/www/nginx/dokuwiki/conf
Now, go to https://domain.com/dokuwiki/install.php and run the installer. Now, it is time to move the data directory and to configure dokuwiki's main .php configuration file to “see” that move.
mv /usr/local/www/nginx/dokuwiki/data /usr/local/www/data cd /usr/local/www/nginx/dokuwiki/conf/ nano local.php
Ok, inside the .php main configuration file for dokuwiki that you just opened, add the following line below that others that specify other global parameters.
$conf['savedir'] = '/usr/local/www/data/';
When you moved the data directory it likely lost its permissions from the above changes. If not, or if you are unsure, execute:
sudo chmod -R 775 /usr/local/www/data sudo chown www -R /usr/local/www/data
Remove the original data directory and restore root as owner of the main configuration directory.
sudo rm -r /usr/local/www/nginx/dokuwiki/data sudo chown -R root /usr/local/www/nginx/dokuwiki/conf
Reload the primary page, make a test submission. Also, log in and select Admin and you should see the security warning removed now. At this point, follow these standard permission recommendations from dokuwiki:
chmod g+rwx /usr/local/www/dokuwiki chmod -R 775 /usr/local/www/data chown -R www /usr/local/www/data [group is wheel, not needed on BSD] chmod 2775 /usr/local/www/data/attic /usr/local/www/data/cache /usr/local/www/data/index /usr/local/www/data/locks /usr/local/www/data/media /usr/local/www/data/meta /usr/local/www/data/pages /usr/local/www/data/tmp chown www /usr/local/www/data/attic /usr/local/www/data/cache /usr/local/www/data/index /usr/local/www/data/locks /usr/local/www/data/media /usr/local/www/data/meta /usr/local/www/data/pages /usr/local/www/data/tmp
— oemb1905 2017/05/16 04:06
