Revision as of 07:48, 17 September 2016

HOW TO: INSTALL NEXTCLOUD 10 ON FREEBSD JAIL

I wrote this guide primarily as a backup in case I needed to redo things over again, and decided to spruce it up and share it with others.

The Goal:

Put Nextcloud 10 on a FreeNAS jail using a standard LAMP setup for FreeBSD (FAMP)

This guide is a mix of several other guides I found for installing OwnCloud. The process for OC9 and NC10 is virtually identical. But most of the guides were out of date in regards to FreeNAS, so I updated it for FreeNAS 9.10.1, Nextcloud 10, Apache 2.4, PHP 7, and MariaDB 10.1 and FreeBSD 10+ Jail. I sourced all of the guides and pages I had used down at the bottom.

Getting Started - 

General Assumptions:

• You are familiar with Linux and comfortable with command line, but not so familiar with FreeBSD
• You have already set up a proper pool for your NextCloud dataset
• You are using FreeNAS 9.10.1-RELEASE with FreeBSD Jail Template "------"
• Your FreeNAS is connected to the internet, and your jails are properly configured.
• That you're generally on a clean install of 9.10.1-RELEASE, upgrades from 9.3, 9.2.1, etc have some issues with jails and templates. I ain't got time for that nonsense so this was a fresh install for me.
• You're using this for maybe a small start-up with no more than 100 users.

'Specifics:'

My Build: A real budget strapped build. (<$1400)

ASRock C2550d4n

16GB Crucial (2x8gb) DDR3-1600 EUDIMM 1.35v

x2 5TB HGST NAS 7200rpm 

x2 2TB Seagate Barracuda 7200rpm (These two are used for my NextCloud setup)

Target: 100+ users for Cloud and Archive storage, currently, with disk-to-disk mirroring. Soon to be expanded to a proper raid when I get the funds.

Creating the Dataset & Jail 

Let's Begin

Pool Name: "SETV_Cloud"

Static IP Address: 10.130.12.191

Create Dataset^[1]

Within FreeNAS Userspace:

Storage > Create ZFS Dataset

• Dataset Name = files
• Compression level = lz4
• Enable atime = Off
• All other options default
• Dataset Name = db
• Compression level = zle
• Enable atime = Off
• Record Size = 16K (Under Advanced Mode)
• All other options default

Create Jail

Jails > Add Jail

• Jail Name: nextcloud
• Template: "------"
• IPv4 Address: 10.130.10.121
• IPv4 Subnet: 255.255.248.0
• Leave all else default
• Ensure VIMAGE is checked

Add Storage

Jails -> Storage

• Jail: nextcloud
• Source = /mnt/SETV_Cloud/files
• Destination = /mnt/files

• Jail: nextcloud
• Source = /mnt/SETV_Cloud/db
• Destination = /var/db/mysql

Setting primary cache

In FreeNAS UserSpace Shell

$ zfs set primarycache=metadata Cloud/db

Configure Jail for SSH

We need to set up the jail to be able to SSH in and make faster adjustments.

Enter the Jail's shell from within FreeNAS

$ pkg upgrade

If it asks any questions, select Y and continue.

Enable SSH

$ cd /etc/ssh

$ vi sshd_config

Personally, I despise vi, but this is the quickest method I have found. Know a way better, please let me know.

if you don't know how to use vi, here's a quick step by step. I suggest you check out this cheat sheet

1. Scroll down using the DOWN arrow key until you find #PermitRootLogin no line.
2. With the cursor on the # hit x this will delete the hash now use the RIGHT arrow key to select the space before 'no'
3. Hit i type yes
4. Hit esc
5. Select the n in 'no' and hit x twice to delete 'no' so the line reads PermitRootLogin yes
6. type :wq
7. Hit ENTER
8. The file is now saved

Now enable and start SSH

$ sysrc sshd_enable=yes

$ service ssh start

Change Jail Root PW

We need to reset the jails root password; type this command, and follow the prompts

$ passwd

Now close the shell within FreeNAS, and use PuTTY to SSH to the jail.

F.A.M.P Installation

In this section we are going to install F.A.M.P, an iteration of LAMP (Linux, Apache, MySQL, PHP). I chose this because I, personally, haven't had much luck with nginx and mariadb. Another guide suggested lighttp and sqlite, but those might not hold up to a good amount of users storing a bit of data.

The setup is:

• FreeBSD 10.1
• Apache 2.4
• MariaDB 10.1
• PHP 7.0

This provides the basis for our webserving jail.

Before we get started, let's add a few necessary packages as they aren't currently installed.

$ pkg install nano wget sudo

We will install each part of FAMP one-by-one. FreeBSD is the Operating system so good to go on that!

Apache 2.4 ^[2]

Install

$ pkg install apache24

Setup in rc.conf

$ sysrc apache24_enable=yes

Start Apache

$ service apache24 start

Check that it works

Navigate to http://192.168.1.99 and you should see the text "It Works!"

MariaDB 10.1 ^[3]

Install

$ pkg install mariadb101-server

Setup in rc.conf

$ sysrc mysql_enable=yes

Run Wizard Script

$ mysql_secure_installation

Read and follow prompts. There is no root password set just hit enter, and answer Y to all the following questions.

Login to MySQL, create Nextcloud DB and User

$ mysql -u root -p

enter password you made for root during setup.

Enter each of these commands one-by-one, and make sure to include the semi-colon ;

Code:

CREATE DATABASE nextcloud; 

CREATE USER 'nextcloud_admin'@'localhost' IDENTIFIED BY 'MAKEUP-YOUR-OWN-PASSWORD'; 

GRANT ALL ON nextcloud.* TO 'nextcloud_admin'@'localhost'; 

FLUSH PRIVILEGES; 

exit 

Replace MAKEUP-YOUR-OWN-PASSWORD with a password of your choosing. You need this for the NextCloud setup.

PHP 7.0

Install PHP and associated modules

Code:

pkg install redis php70-bz2 php70-ctype php70-curl php70-dom php70-exif php70-fileinfo php70-filter php70-gd php70-hash php70-iconv php70-intl php70-json php70-mbstring php70-mcrypt php70-pdo_mysql php70-openssl php70-posix php70-session php70-simplexml php70-xml php70-xmlreader php70-xmlwriter php70-xsl php70-wddx php70-zip php70-zlib php70-APCu php70-redis

Setup rc.conf

sysrc 'mysql_enable=YES' 'redis_enable=YES'

Configuring Apache for PHP7

Ensure that the rewrite and ssl modules are enabled (uncommented) in /usr/local/etc/apache24/httpd.conf.

$ cd /usr/local/etc/apache24/

$ nano httpd.conf

Search the conf file for "ssl_module"

Code:

ctrl+w 
ssl_module 
ENTER

Uncomment (delete the # at the start of the line) so it looks like this:

LoadModule ssl_module libexec/apache24/mod_ssl.so

Repeat for

LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Remove php5 add php7: ^[4][5]

• Find & Remove this >> LoadModule php5_module libexec/apache24/libphp5.so
• Replace with >> LoadModule php7_module libexec/apache24/libphp7.so

Right after libphp7.so line add

Code:

<IfModule php5_module>
   <FilesMatch "\.(php|phps|php5|phtml)$">
       SetHandler php5-script
   </FilesMatch>
   DirectoryIndex index.php 
</IfModule>

Then FIND <IFModule mime_module>

Insert Right After:

Code:

AddType application/x-httpd-php-source .phps
AddType application/x-httpd-php        .php

Save the file & exit

Add a PHP handler

# cd/usr/local/etc/apache24/modules.d

# touch /usr/local/etc/apache24/modules.d/001_mod_php.conf

# nano /usr/local/etc/apache24/modules.d/001_mod_php.conf

Paste:

Code:

<FilesMatch "\.php$">
        SetHandler application/x-httpd-php
    </FilesMatch>
    <FilesMatch "\.phps$">
        SetHandler application/x-httpd-php-source
    </FilesMatch>
 </IfModule>

Save & Exit

service apache24 restart

Once you're done save and close CTRL+x, Y, ENTER

Configure PHP.INI ^[6]

$ nano /usr/local/etc/php.ini

find cgi.fix_pathinfo=0 change from =0 to =1

find date.timezone = Change to your timezone (America/New_York)

find post_max_size= change it to 1999M

find upload_max_size= change to 1999M

CTRL+X, Y, ENTER

Restart Apache

$ service apache24 restart

Testing with PHPINFO() ^[7][8]

Navigate to /usr/local/www/apache24/data/

$ touch info.php

$ nano info.php

Paste:

Code:

<?php
 // Show all information, defaults to INFO_ALL
 phpinfo();
 ?>

Save & Exit

Navigate to http://192.168.1.99/info.php

You should see a full page with all the information regarding your PHP installation.

Configure REDIS ^[9]

Update /usr/local/etc/redis.confto run on local socket

Find port= and change it to 0

Find and replace:

Code:

unixsocket /tmp/redis.sock 
unixsocketperm 750

Add REDIS to rc.conf

$ sysrc redis_enable=yes

Start REDIS

$ service redis start

Check Redis

Run ls -al /tmp to run on local socket, you should see redis.sock and mysql.sock in the list.

If you see those two, you're ALMOST DONE!!

Installing NextCloud^[10]

Download

Go to the default apache data directory

$ cd /usr/local/www/apache24/data

Download Nextcloud

$ wget https://download.nextcloud.com/server/releases/nextcloud-10.0.0.zip

Unzip Nextcloud

$ unzip nextcloud-10.0.0.zip

Give correct owner

chown -R www:www /usr/local/www/apache24/data/nextcloud /mnt/files

Add virtual Host info ^[11]

Navigate to /usr/local/etc/apache24/Includes

Touch file:

$ touch cloud.YOURDOMAIN.com.conf

$ nano cloud*

Copy and paste the below text.

I commented out mod_rewrite and did not include SSL because I am waiting to setup a real domain to attach to it and did not want to run into issues until I had the domain.

Code:

<VirtualHost *:80> DocumentRoot "/usr/local/www/apache24/data/nextcloud" ServerName cloud.ssdcougars.tv #   RewriteEngine on #   RewriteCond %{SERVER_NAME} =cloud.ssdcougars.tv #   RewriteRule ^ https://%{SERVER_NAME}%{REQUEST_URI} [END,QSA,R=permanent] #ErrorLog ${APACHE_LOG_DIR}/error.log #CustomLog ${APACHE_LOG_DIR}/access.log combined <Directory /usr/local/www/apache24/data/nextcloud/> Options +FollowSymlinks AllowOverride All <IfModule mod_dav.c> Dav off </IfModule> SetEnv HOME /usr/local/www/apache24/data/nextcloud SetEnv HTTP_HOME /usr/local/www/apache24/data/nextcloud Satisfy Any </Directory> </VirtualHost>

Restart apache... again...

$ service apache24 restart

Navigate to the website

http://192.168.1.99/

You should now see the setup screen for NextCloud!!

If you do, give yourself a pat on the back. Now for the last steps...

'NextCloud WebUI'

Set up your admin account with a username and password you choose.

Storage & database

• Data folder = /mnt/files
• Database user = nextcloud_admin
• Database password = MADEUP_PASSWORD_FROM_BEFORE
• Database name = nextcloud
• Database host = localhost:/tmp/mysql.sock

Final Setup

In Jail Shell

Setup redis for caching

Code:

$ su -m www -c 'php /usr/local/www/apache24/data/nextcloud/occ config:system:set memcache.local --value="\OC\Memcache\APCu"' 
$ su -m www -c 'php /usr/local/www/apache24/data/nextcloud/occ config:system:set memcache.locking --value="\OC\Memcache\Redis"' 
$ su -m www -c 'php /usr/local/www/apache24/data/nextcloud/occ config:system:set redis host --value="/tmp/redis.sock"' 
$ su -m www -c 'php /usr/local/www/apache24/data/nextcloud/occ config:system:set redis port --value=0 --type=integer'

Setup NC's cron jobs

crontab -u www -e

Code:

*/15 * * * * /usr/local/bin/php -f /usr/local/www/apache24/data/nextcloud/cron.php

And VOILA! YOU ARE DONE!!!!!

1. ↑ https://forums.freenas.org/index.php?threads/how-to-owncloud-using-nginx-php-fpm-and-mysql.17786/
2. ↑ https://www.digitalocean.com/community/tutorials/how-to-install-an-apache-mysql-and-php-famp-stack-on-freebsd-10-1
3. ↑ https://levlaz.org/installing-nextcloud-on-a-freebsd-vps/
4. ↑ http://serverfault.com/questions/646333/apache-24-not-serving-php-on-freebsd-10
5. ↑ https://kdenby.homelinux.com/?p=208
6. ↑ https://forums.freenas.org/index.php?threads/how-to-owncloud-using-nginx-php-fpm-and-mysql.17786/
7. ↑ https://mediatemple.net/community/products/dv/204643880/how-can-i-create-a-phpinfo.php-page
8. ↑ https://www.digitalocean.com/community/tutorials/how-to-install-an-apache-mysql-and-php-famp-stack-on-freebsd-10-1
9. ↑ https://levlaz.org/installing-nextcloud-on-a-freebsd-vps/
10. ↑ https://levlaz.org/installing-nextcloud-on-a-freebsd-vps/
11. ↑ https://www.linuxbabe.com/cloud-storage/setup-nextcloud-server-ubuntu-16-04-apache-mariadb-php7