Difference between revisions of "Nextcloud"

From SME Server
Jump to navigationJump to search
(33 intermediate revisions by 5 users not shown)
Line 11: Line 11:
 
|description_image= {{#var:contribname}} logo
 
|description_image= {{#var:contribname}} logo
 
|maintainer= Unnilennium
 
|maintainer= Unnilennium
−
|licence= GPL
+
|licence= AGPLv3
−
|url= https://nextcloud.org
+
|url= https://nextcloud.com
 
|category= Contrib
 
|category= Contrib
 
|tags=cloud,files,dropbox,seafile,pydio,ajaxplorer,owncloud
 
|tags=cloud,files,dropbox,seafile,pydio,ajaxplorer,owncloud
 
}}
 
}}
−
 
 
===Maintainer===
 
===Maintainer===
 
<!-- here you need to file your username and name -->
 
<!-- here you need to file your username and name -->
Line 28: Line 27:
 
=== Description ===
 
=== Description ===
 
Nextcloud is a suite of client-server software for creating and using file hosting services. It is functionally similar to Dropbox, although Nextcloud is free and open-source, allowing anyone to install and operate it on a private server.
 
Nextcloud is a suite of client-server software for creating and using file hosting services. It is functionally similar to Dropbox, although Nextcloud is free and open-source, allowing anyone to install and operate it on a private server.
 +
 +
As per SME Server Keep It Simple, all your ibays and home folders will be accessible through the nextcloud interface using the "external files" app. You will also have your main user user Nextcloud folder saved under /home/e-smith/files/owncloud/data which is in the default backup path. So you can now enjoy both your own cloud repository with access to the very same files on your samba share!
 +
 +
How do I add my SME users ? They are already there ! Just tell them to connect to https://mydomain/nextcloud. You can also add external users or allow them to register with a nextcloud app.
 +
 +
What are the admin ? By default you have a nextcloudadmin user and the regular SME admin user. First one use the password you can see with "config getprop nextcloud AdminPassword", and second one, well, just use your regular admin password. Then you can manage apps, external files repos and admin group membership.
  
 
=== Installation ===
 
=== Installation ===
−
  yum install smeserver-extrarepos-remi-safe smeserver-extrarepos-fws
+
You do not need to  follow the Repo pages of [https://wiki.contribs.org/Fws fws] and [https://wiki.contribs.org/Remi-safe remi-safe] to isntall those two needed repos, instead use the packages to install them followed by a yum-modify event. Then run the main installation.
 +
  yum install smeserver-extrarepositories-remi-safe smeserver-extrarepositories-fws smeserver-extrarepositories-epel
 
  signal-event yum-modify
 
  signal-event yum-modify
−
  yum --enablerepo=smecontribs install {{#var:smecontribname}} --enablerepo=smecontribs,fws,remi-safe,smedev,smetest
+
  yum install {{#var:smecontribname}} --enablerepo=smecontribs,epel,fws
 +
signal-event webapps-update
 +
service php-fpm start
 +
service php71-php-fpm start
 +
signal-event nextcloud-update
 +
 
 +
you can skip the service php-fpm* commands if it was already installed and running before the installation of nextcloud
 +
 
 +
then you can do the following and you can safely ignore the signal-event post-upgrade reboot if prompted, unless you also installed other packages that needs to do so.
 +
config set UnsavedChanges no
 +
 
 +
or do
 +
signal-event post-upgrade
 +
signal-event reboot
 +
 
 +
=== Upgrade ===
 +
yum  update {{#var:smecontribname}} {{#var:contribname}} smeserver-php-fpm smeserver-webapps-common  --enablerepo=smecontribs,epel,fws
 +
signal-event nextcloud-update
 +
 
 +
=== Configuration ===
 +
{| class="wikitable"
 +
!property
 +
!default
 +
!values
 +
!
 +
|-
 +
|AdminPassword
 +
|GENERATED
 +
|string
 +
|password for your main admin user for nextcloud *
 +
|-
 +
|AdminUser
 +
|nextcloudadmin
 +
|string
 +
|main admin user for your installation *
 +
|-
 +
|DbName
 +
|nextcloud
 +
|string
 +
|for mysql db
 +
|-
 +
|DbPassword
 +
|GENERATED
 +
|string
 +
|for mysql db
 +
|-
 +
|DbUser
 +
|nextcloud
 +
|string
 +
|for mysql db
 +
|-
 +
|TrustedDomains
 +
|empty
 +
|strings coma separated
 +
|add domain or ip that are in need to be added to default access to nextcloud
 +
|-
 +
|VirtualHost
 +
|empty
 +
|domain name
 +
|
 +
|-
 +
|access
 +
|private
 +
|private, public
 +
|
 +
|-
 +
|status
 +
|enabled
 +
|enabled,disabled
 +
|
 +
|-
 +
|MaxUploadSize
 +
|4096M
 +
|number
 +
|if a number will be converted to Megabytes, otherwise use the usual suffix : 2T for 2 terrabytes etc...
 +
|-
 +
|MemoryLimit
 +
|528M
 +
|number
 +
|if a number will be converted to Megabytes, otherwise use the usual suffix : 2T for 2 terrabytes etc...
 +
|-
 +
|Shares
 +
|enabled
 +
|enabled,disabled
 +
|add the samba shares from the shared-folders contrib in the nextcloud ibays folder along with regular ibays
 +
|-
 +
|IncludeIbay
 +
|empty
 +
|strings coma separated
 +
|add ibays names that need to be include. If not empty, only the name present here will be accessible via nextcloud. Take precedence over ExcludeIbay. You set it with a random string to exclude all ibays and shares from automatic inclusion.
 +
|-
 +
|ExcludeIbay
 +
|Primary
 +
|strings coma separated
 +
|will exclude from nexcloud access any ibay via nextcloud. Default excludes Primary ibay. If you want to include Primary set it with a random string.
 +
|-
 +
|UseSMB
 +
|enabled
 +
|enabled,disabled
 +
|allow you to set ibay access via samba share or via Local driver in nextcloud. Enabled is for samba, this allow you to access as your user and have your quota accounted. It might be a little slower, and need you to have your password loaded in the session. Local driver if disabled, will let you access only what apache user (www) has right to access as member of a group.
 +
|}
 +
* the SME admin user is also an admin of your nextcloud installation. You have two admin account as per default installation on SME Server.
 +
 
 +
 
 +
example of setting :
 +
  config setprop nextcloud ExcludeIbay ibay1,ibay2
 +
  signal-event nextcloud-update
 +
 
 +
=== Command line ===
 +
if you happen to need tweaking your installation, here is how to access the command line for Nextcloud on SME, we made it easier for you, just log as root and use the OCC command (using capitals), This command will execute for you what you need as the www user, using the needed version of php. Here two examples: <syntaxhighlight lang="bash">
 +
OCC maintenance:mode --off
 +
OCC maintenance:repair
 +
 
 +
</syntaxhighlight>to seek for additional command consult Nextcloud documentation : https://docs.nextcloud.com/server/13.0.0/admin_manual/configuration_server/occ_command.html
  
 
=== Uninstall ===
 
=== Uninstall ===
 
  yum remove {{#var:smecontribname}}  {{#var:contribname}}
 
  yum remove {{#var:smecontribname}}  {{#var:contribname}}
 +
 +
=== Use a dedicated domain to connect to Nextcloud ===
 +
<syntaxhighlight lang="bash">
 +
db domains set cloud.mydomain.com domain Description "Nextcloud" Content Primary Nameservers internet TemplatePath WebAppVirtualHost DocumentRoot /usr/share/nextcloud RequireSSL enabled letsencryptSSLcert enabled
 +
signal-event domain-create cloud.mydomain.com
 +
 +
#only if you use a Let's Encrypt certificate
 +
expand-template /etc/dehydrated/domains.txt
 +
dehydrated -c
 +
 +
#to let nextcloud accept this domain
 +
OCC "config:system:set trusted_domains 10 --value=cloud.mydomain.com "
 +
</syntaxhighlight>
 +
 +
=== Mount with davfs on Fedora Clients ===
 +
While you might love the easy setup of the gnome client for nextcloud, you might encounter some frustration of having your favourite applications not showing nextcloud as mounted and needing to find it to sometime not being able to access it.
 +
 +
Here is a workaround
 +
 +
First as root<syntaxhighlight lang="bash">
 +
dnf install davfs2 -y
 +
usermod -aG davfs2 $YOURUSER
 +
echo "use_locks 0" >> /etc/davfs2/davfs2.conf
 +
echo "https://example.com/nextcloud/remote.php/webdav /home/$YOURUSER/nextcloud davfs user,rw,auto 0 0
 +
" >> /etc/fstab
 +
 +
 +
</syntaxhighlight>then you should log out /log in with your user in order to have the group membership. You can also just do "su -l USERNAME"
 +
 +
then as your user (replace your_password by your password, or a token;):<syntaxhighlight lang="bash">
 +
mkdir ~/nextcloud
 +
mkdir ~/.davfs2
 +
echo "https://example.com/nextcloud/remote.php/webdav your_Nextcloud_username your_password" >> ~/.davfs2/secrets
 +
chmod 0600 ~/.davfs2/secrets
 +
</syntaxhighlight>then just mount ! <syntaxhighlight lang="bash">
 +
mount ~/nextcloud
 +
</syntaxhighlight>
 +
 +
From there you can tweak the cache configuration to make it easier for you if you are far from the server, default cache size is 50MiByte, you could increase it to let's say 3 GiByte in ~/.davfs2/davfs2.conf for your user <syntaxhighlight lang="bash">
 +
cache_size 3G
 +
</syntaxhighlight>you should see the folder mount at every logon from now on!  if you do not want that, change "auto" in the fstab by "noauto".
 +
 +
Then add the following in ~/bash_profile or ~/bash_rc. You could user also mount -a and to try to put something in /etc/gdm/PostLogin/" instead<syntaxhighlight lang="bash">
 +
mount /home/username/nextcloud
 +
 +
 +
 +
</syntaxhighlight>And Finally to umount in  gdm using "sudo vim /etc/gdm/PostSession/"<syntaxhighlight lang="bash">
 +
if [ ${USERNAME} = "myuser" ];then
 +
  umount -fl /home/myuser/nextcloud
 +
fi
 +
</syntaxhighlight>
 +
 +
Adapted from those sources:
 +
* http://www.tuxfixer.com/mount-webdav-remote-storage-in-fedora-linux-via-davfs2/
 +
* https://docs.nextcloud.com/server/13/user_manual/files/access_webdav.html
 +
 +
=== Known issues ===
 +
 +
==== failure to do online upgrade from 13.0.2 ====
 +
The following extra files have been found:    assets
 +
<syntaxhighlight lang="bash">
 +
cd /usr/share/nextcloud/
 +
rm -rf assets
 +
yum update smeserver-nextcloud --enablerepo=smecontribs
 +
signal-event nextcloud-update
 +
</syntaxhighlight>then proceed to online web upgrade
 +
 +
==== issue upgrading from 13.0.2 to 15.0.0 RPM ====
 +
Nextcloud is only build to upgrade from one major release to the next. If you try to install the nextcloud-15 rpm while you already have installed the nextcloud-13, you might have encounter the following issue.
 +
 +
'''“Updates between multiple major versions are unsupported”'''
 +
 +
<tt>goto usr/share/nextcloud</tt>
 +
 +
copy everything except <tt>/data</tt> and <tt>/config</tt> to temp folder
 +
 +
download intermediate version of '''nextcloud''' from <nowiki>https://nextcloud.com/changelog/</nowiki>
 +
 +
unzip and copy files to /usr/share/nextcloud, dont overwrite /data or /config
 +
 +
change ownership in /usr/share/nextcloud chown -R apache:www .
 +
 +
goto <nowiki>https://yoururl/nextcloud</nowiki> and run the updater
 +
 +
logon to nextcloud and make sure it is all working as expected
 +
 +
repeat above for each major update until you are one update from the latest major update. At that point you can follow the usual process. source (https://bugs.contribs.org/show_bug.cgi?id=10670#c3)
 +
 +
==== Upgrading from 17.0.1.x to 17.07.x ====
 +
 +
You can use the built in updater.
 +
The only issue experienced was right at the end of the process with a http 500 error. I just did 'retry' and it completed.
 +
 +
You may need to update your database which I did as follows - note it may take a very long time with a lot of files:
 +
 +
OCC maintenance:mode --on
 +
OCC db:convert-filecache-bigint
 +
OCC maintenance:mode --off
 +
 +
==== User cannot see shares/files ====
 +
 +
After a new install the admin user could see shares but not a user.
 +
 +
We had a single ibay and it was set:
 +
 +
Group Everyone
 +
Write group
 +
Read everyone
 +
 +
We created a new group called localusers and added the admin and single user.
 +
 +
We then set the ibay:
 +
 +
Group localusers
 +
Write group
 +
Read group
 +
 +
This appeared to fix the issue and the user could now see the files.
  
 
=== Bugs ===
 
=== Bugs ===
Line 51: Line 289:
 
<!-- list of category you want to see this page in -->
 
<!-- list of category you want to see this page in -->
 
[[Category: Contrib]]
 
[[Category: Contrib]]
−
 
 
<!-- Please keep there the template revision  number as is -->
 
<!-- Please keep there the template revision  number as is -->

Revision as of 18:00, 6 July 2020

Geographylogo.png Languages: 

English  • français




nextcloud
Nextcloud Logo.svg
nextcloud logo
MaintainerUnnilennium
Urlhttps://nextcloud.com
LicenceAGPLv3
Category

Contrib

Tags cloud, files, dropbox, seafile, pydio, ajaxplorer, owncloud


Maintainer

Jean-Philippe Pialasse

Version

Contrib 10:
Contrib 9:
smeserver-nextcloud
The latest version of smeserver-nextcloud is available in the SME repository, click on the version number(s) for more information.


Contrib 9:
nextcloud
The latest version of nextcloud is available in the SME repository, click on the version number(s) for more information.


Description

Nextcloud is a suite of client-server software for creating and using file hosting services. It is functionally similar to Dropbox, although Nextcloud is free and open-source, allowing anyone to install and operate it on a private server.

As per SME Server Keep It Simple, all your ibays and home folders will be accessible through the nextcloud interface using the "external files" app. You will also have your main user user Nextcloud folder saved under /home/e-smith/files/owncloud/data which is in the default backup path. So you can now enjoy both your own cloud repository with access to the very same files on your samba share!

How do I add my SME users ? They are already there ! Just tell them to connect to https://mydomain/nextcloud. You can also add external users or allow them to register with a nextcloud app.

What are the admin ? By default you have a nextcloudadmin user and the regular SME admin user. First one use the password you can see with "config getprop nextcloud AdminPassword", and second one, well, just use your regular admin password. Then you can manage apps, external files repos and admin group membership.

Installation

You do not need to follow the Repo pages of fws and remi-safe to isntall those two needed repos, instead use the packages to install them followed by a yum-modify event. Then run the main installation. 

yum install smeserver-extrarepositories-remi-safe smeserver-extrarepositories-fws smeserver-extrarepositories-epel
signal-event yum-modify
yum install smeserver-nextcloud --enablerepo=smecontribs,epel,fws
signal-event webapps-update
service php-fpm start
service php71-php-fpm start
signal-event nextcloud-update

you can skip the service php-fpm* commands if it was already installed and running before the installation of nextcloud

then you can do the following and you can safely ignore the signal-event post-upgrade reboot if prompted, unless you also installed other packages that needs to do so. 

config set UnsavedChanges no

or do 

signal-event post-upgrade 
signal-event reboot

Upgrade

yum  update smeserver-nextcloud nextcloud smeserver-php-fpm smeserver-webapps-common  --enablerepo=smecontribs,epel,fws
signal-event nextcloud-update

Configuration

property default values
AdminPassword GENERATED string password for your main admin user for nextcloud *
AdminUser nextcloudadmin string main admin user for your installation *
DbName nextcloud string for mysql db
DbPassword GENERATED string for mysql db
DbUser nextcloud string for mysql db
TrustedDomains empty strings coma separated add domain or ip that are in need to be added to default access to nextcloud
VirtualHost empty domain name
access private private, public
status enabled enabled,disabled
MaxUploadSize 4096M number if a number will be converted to Megabytes, otherwise use the usual suffix : 2T for 2 terrabytes etc...
MemoryLimit 528M number if a number will be converted to Megabytes, otherwise use the usual suffix : 2T for 2 terrabytes etc...
Shares enabled enabled,disabled add the samba shares from the shared-folders contrib in the nextcloud ibays folder along with regular ibays
IncludeIbay empty strings coma separated add ibays names that need to be include. If not empty, only the name present here will be accessible via nextcloud. Take precedence over ExcludeIbay. You set it with a random string to exclude all ibays and shares from automatic inclusion.
ExcludeIbay Primary strings coma separated will exclude from nexcloud access any ibay via nextcloud. Default excludes Primary ibay. If you want to include Primary set it with a random string.
UseSMB enabled enabled,disabled allow you to set ibay access via samba share or via Local driver in nextcloud. Enabled is for samba, this allow you to access as your user and have your quota accounted. It might be a little slower, and need you to have your password loaded in the session. Local driver if disabled, will let you access only what apache user (www) has right to access as member of a group.
  • the SME admin user is also an admin of your nextcloud installation. You have two admin account as per default installation on SME Server.


example of setting : 

 config setprop nextcloud ExcludeIbay ibay1,ibay2
 signal-event nextcloud-update

Command line

if you happen to need tweaking your installation, here is how to access the command line for Nextcloud on SME, we made it easier for you, just log as root and use the OCC command (using capitals), This command will execute for you what you need as the www user, using the needed version of php. Here two examples: 

OCC maintenance:mode --off
OCC maintenance:repair

to seek for additional command consult Nextcloud documentation : https://docs.nextcloud.com/server/13.0.0/admin_manual/configuration_server/occ_command.html

Uninstall

yum remove smeserver-nextcloud  nextcloud

Use a dedicated domain to connect to Nextcloud

db domains set cloud.mydomain.com domain Description "Nextcloud" Content Primary Nameservers internet TemplatePath WebAppVirtualHost DocumentRoot /usr/share/nextcloud RequireSSL enabled letsencryptSSLcert enabled
signal-event domain-create cloud.mydomain.com

#only if you use a Let's Encrypt certificate
expand-template /etc/dehydrated/domains.txt
dehydrated -c

#to let nextcloud accept this domain
OCC "config:system:set trusted_domains 10 --value=cloud.mydomain.com "

Mount with davfs on Fedora Clients

While you might love the easy setup of the gnome client for nextcloud, you might encounter some frustration of having your favourite applications not showing nextcloud as mounted and needing to find it to sometime not being able to access it.

Here is a workaround

First as root

dnf install davfs2 -y
usermod -aG davfs2 $YOURUSER
echo "use_locks 0" >> /etc/davfs2/davfs2.conf
echo "https://example.com/nextcloud/remote.php/webdav /home/$YOURUSER/nextcloud davfs user,rw,auto 0 0
" >> /etc/fstab

then you should log out /log in with your user in order to have the group membership. You can also just do "su -l USERNAME" then as your user (replace your_password by your password, or a token;):

mkdir ~/nextcloud
mkdir ~/.davfs2
echo "https://example.com/nextcloud/remote.php/webdav your_Nextcloud_username your_password" >> ~/.davfs2/secrets 
chmod 0600 ~/.davfs2/secrets

then just mount ! 

mount ~/nextcloud

From there you can tweak the cache configuration to make it easier for you if you are far from the server, default cache size is 50MiByte, you could increase it to let's say 3 GiByte in ~/.davfs2/davfs2.conf for your user 

cache_size 3G

you should see the folder mount at every logon from now on! if you do not want that, change "auto" in the fstab by "noauto". Then add the following in ~/bash_profile or ~/bash_rc. You could user also mount -a and to try to put something in /etc/gdm/PostLogin/" instead

mount /home/username/nextcloud

And Finally to umount in gdm using "sudo vim /etc/gdm/PostSession/"

if [ ${USERNAME} = "myuser" ];then
  umount -fl /home/myuser/nextcloud
fi

Adapted from those sources:

Known issues

failure to do online upgrade from 13.0.2

The following extra files have been found:    assets

cd /usr/share/nextcloud/
rm -rf assets
yum update smeserver-nextcloud --enablerepo=smecontribs
signal-event nextcloud-update

then proceed to online web upgrade

issue upgrading from 13.0.2 to 15.0.0 RPM

Nextcloud is only build to upgrade from one major release to the next. If you try to install the nextcloud-15 rpm while you already have installed the nextcloud-13, you might have encounter the following issue.

“Updates between multiple major versions are unsupported”

goto usr/share/nextcloud

copy everything except /data and /config to temp folder

download intermediate version of nextcloud from https://nextcloud.com/changelog/

unzip and copy files to /usr/share/nextcloud, dont overwrite /data or /config

change ownership in /usr/share/nextcloud chown -R apache:www .

goto https://yoururl/nextcloud and run the updater

logon to nextcloud and make sure it is all working as expected

repeat above for each major update until you are one update from the latest major update. At that point you can follow the usual process. source (https://bugs.contribs.org/show_bug.cgi?id=10670#c3)

Upgrading from 17.0.1.x to 17.07.x

You can use the built in updater. The only issue experienced was right at the end of the process with a http 500 error. I just did 'retry' and it completed.

You may need to update your database which I did as follows - note it may take a very long time with a lot of files: 

OCC maintenance:mode --on
OCC db:convert-filecache-bigint
OCC maintenance:mode --off

User cannot see shares/files

After a new install the admin user could see shares but not a user.

We had a single ibay and it was set: 

Group Everyone
Write group
Read everyone

We created a new group called localusers and added the admin and single user.

We then set the ibay: 

Group localusers
Write group
Read group

This appeared to fix the issue and the user could now see the files.

Bugs

Please raise bugs under the SME-Contribs section in bugzilla and select the smeserver-nextcloud component or use this link


Below is an overview of the current issues for this contrib:

IDProductVersionStatusSummary (8 tasks) ⇒
12685SME Contribs10.0VERIFIEDInstall fails when attempting occ cmd at cli and no browser access
12611SME Contribs10.0RESOLVEDupdate cron script with maintenance_window_start
12609SME Contribs10.0CONFIRMEDsmeserver-nextcloud S30nextcloud-occ-conf errors when run via ddclient panel
12487SME Contribs10.0CONFIRMEDupdate nextcloud fail2ban filter
12486SME Contribs10.0RESOLVEDocc requires /sbin/e-smith to be in the path
12406SME Contribs10.0CONFIRMEDNFR switch to PHP83 support for NC 29 and after
11169SME Contribs10alphaCONFIRMEDsmeserver-nextcloud requires a modify script
10566SME Contribs10.0CONFIRMEDNFR: split action nextcloud-occ-conf

Changelog

Only released version in smecontrib are listed here.

smeserver-nextcloud Changelog: SME 10 (smecontribs)
2024/05/16 Jean-Philippe Pialasse 1.2.0-31.sme
- fix php version on initial install [SME: 12685]

2024/04/12 Jean-Philippe Pialasse 1.2.0-30.sme
- add maintenance windows start [SME: 12611]

 increase frequency of cron task every 5 min
- fix missing full path [SME: 12486]

2024/01/29 Jean-Philippe Pialasse 1.2.0-29.sme
- require nextcloud-src >= 26 [SME: 12318]

 multiple fixes and rewrites
- restore default log level [SME: 12412]

2023/09/09 Jean-Philippe Pialasse 1.2.0-28.sme
- workaround opcache segfault with php 81 using in memory only [SME: 12298]

- index file cache using Redis [SME: 12401]
2023/09/09 John Crisp 1.2.0-27.sme
- Fix syntax error in 20opcache.ini [SME: 12298]
Retrieved from "https://wiki.koozali.org/index.php?title=Nextcloud&oldid=38832"