More nextcloud

docs/_source/cloud-libre-is.rst

@@ -35,7 +35,8 @@ Initial setup of Apache with Certbot.
   sudo su -
   apt install python3-certbot-apache php php-fpm php-gd php-json php-xml \
     php-curl php-mbstring php-zip php-mysql php-intl php-imap php-bcmath \
-    php-gmp php-apcu php-redis php-imagick imagemagick ffmpeg
+    php-gmp php-apcu php-redis php-imagick imagemagick ffmpeg \
+    redis-server
   echo "cloud.libre.is" > /var/www/html/index.html
   certbot -d cloud.libre.is
   a2enmod rewrite headers env dir mime setenvif ssl proxy_fcgi
@@ -161,6 +162,23 @@ Then restart apache...
 
   sudo systemctl restart apache2
 
+redis
+=====
+Make some redis config changes.
+Edit /etc/redis/redis.conf
+
+.. code-block:: cfg
+
+  bind 127.0.0.1
+  unixsocket /run/redis/redis-server.sock
+  unixsocketperm 770
+
+Then restart redis.
+
+.. code-block:: sh
+
+  sudo systemctl restart redis-server
+
 
 Nextcloud
 =========
@@ -243,19 +261,95 @@ Now go to the new site and configure via web browser:
 
   `<https://cloud.libre.is/>`_
 
+Create an admin account with password.
 
-Config changes:
+Settings:
+
+* Database: nextcloud
+* Database user: nextcloud
+* Database password: password used when creating nextcloud db above.
+* Install recommended apps. After installing apps, it appears to hang at the dashboard with just
+  a big white box. Clicking outside the box fixes it.
+* Click in upper right corner icon and go to "Administration Settings".
+
+
+Make some config changes. Edit
+/var/www/html/nextcloud/config/config.php
+and add under "'installed' => true," this:
 
 .. code-block:: cfg
 
-  'overwrite.cli.url' => 'https://cloud.libre.is/',
+    'htaccess.RewriteBase' => '/',
-  'htaccess.RewriteBase' => '/',
+    'memcache.local' => '\\OC\\Memcache\\APCu',
+    # 'memcache.distributed' => '\\OC\\Memcache\\Redis',
+    'memcache.locking' => '\\OC\\Memcache\\Redis',
+    'redis' =>
+    array (
+      'host' => '/run/redis/redis-server.sock',
+      'port' => 0,
+    ),
+    'maintenance_window_start' => 1,
+    'default_language' => 'en',
+    'force_language' => 'en',
+    'default_locale' => 'en_US',
+    'force_locale' => 'en_US',
+    'default_phone_region' => 'US',
+    'default_timezone' => 'America/New_York',
+    'knowledgebaseenabled' => false,
+    'mail_domain' => 'libre.is',
+    'overwritehost' => 'cloud.libre.is',
+    'overwriteprotocol' => 'https',
+    'updatechecker' => false,
+    'defaultapp' => 'calendar,tasks',
+    'mail_smtpmode' => 'smtp',
+    'mail_smtpsecure' => 'ssl',
+    'mail_sendmailmode' => 'smtp',
+    'maintenance' => false,
 
-Update config:
+Note, memcache.distributed is borken.
+
+Edit /etc/php/8.2/apache2/php.ini and /etc/php/8.2/fpm/php.ini
+in the [opcache] section, set these values then restart apache:
+
+.. code-block:: ini
+
+  opcache.enable=1
+  opcache.enable_cli=0
+  opcache.memory_consumption=512
+  opcache.interned_strings_buffer=64
+  opcache.max_accelerated_files=50000
+  opcache.max_wasted_percentage=15
+  opcache.validate_timestamps=0
+  opcache.revalidate_freq=0
+  opcache.save_comments=1
+
+
+
+
+Update config. The config script needs a wrapper to run from the command line.
+Create /usr/local/sbin/nextcloud-occ with these contents:
 
 .. code-block:: sh
 
-  sudo -u www-data php /var/www/nextcloud/occ maintenance:update:htaccess
+  #!/bin/bash
+  sudo -u www-data php --define apc.enable_cli=1 /var/www/html/nextcloud/occ "$@"
+
+Then make it executable:
+
+.. code-block:: sh
+
+  chown root:root /usr/local/sbin/nextcloud-occ
+  chmod 700 /usr/local/sbin/nextcloud-occ
+
+
+Run OCC updates:
+
+.. code-block:: sh
+
+  sudo nextcloud-occ maintenance:update:htaccess
+  sudo nextcloud-occ maintenance:repair --include-expensive
+  sudo nextcloud-occ db:add-missing-indices
+
 
 Background jobs:
 
@@ -267,3 +361,9 @@ FPM config:
   `<https://www.php.net/manual/en/install.fpm.php>`_
 
 
+Move the install log out of the way:
+
+.. code-block:: sh
+
+  sudo mv /var/www/html/nextcloud/data/nextcloud.log \
+    /var/www/html/nextcloud/data/nextcloud-install.log

docs/_source/locale/en/LC_MESSAGES/cloud-libre-is.po

@@ -9,7 +9,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Libre Developers Documentation 0\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-09-02 09:07-0600\n"
+"POT-Creation-Date: 2024-09-02 10:01-0600\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: en\n"
@@ -29,7 +29,7 @@ msgid "Administrator documentation for Libre Cloud."
 msgstr ""
 
 #: ../../../_source/cloud-libre-is.rst:6
-#: ../../../_source/cloud-libre-is.rst:244
+#: ../../../_source/cloud-libre-is.rst:262
 msgid "`<https://cloud.libre.is/>`_"
 msgstr ""
 
@@ -73,110 +73,178 @@ msgstr ""
 msgid "Initial setup of Apache with Certbot."
 msgstr ""
 
-#: ../../../_source/cloud-libre-is.rst:45
+#: ../../../_source/cloud-libre-is.rst:46
 msgid "Some PHP config...XXX"
 msgstr ""
 
-#: ../../../_source/cloud-libre-is.rst:71
+#: ../../../_source/cloud-libre-is.rst:72
 msgid "Database"
 msgstr ""
 
-#: ../../../_source/cloud-libre-is.rst:72
+#: ../../../_source/cloud-libre-is.rst:73
 msgid "Use MariaDB for the databse."
 msgstr ""
 
-#: ../../../_source/cloud-libre-is.rst:74
+#: ../../../_source/cloud-libre-is.rst:75
 msgid ""
 "`<https://docs.nextcloud.com/server/latest/admin_manual/"
 "configuration_database/linux_database_configuration.html>`_"
 msgstr ""
 
-#: ../../../_source/cloud-libre-is.rst:82
+#: ../../../_source/cloud-libre-is.rst:83
 msgid "Then in the database:"
 msgstr ""
 
-#: ../../../_source/cloud-libre-is.rst:92
+#: ../../../_source/cloud-libre-is.rst:93
 msgid "Edit /etc/mysql/my.cnf to look like this:"
 msgstr ""
 
-#: ../../../_source/cloud-libre-is.rst:129
+#: ../../../_source/cloud-libre-is.rst:130
 msgid "Restart database:"
 msgstr ""
 
-#: ../../../_source/cloud-libre-is.rst:135
+#: ../../../_source/cloud-libre-is.rst:136
 msgid ""
 "Edit PHP file /etc/php/8.2/apache2/conf.d/20-pdo_mysql.ini for MariaDB. XXX "
 "maybe too: /etc/php/8.2/cli/conf.d/20-pdo_mysql.ini /etc/php/8.2/fpm/conf."
 "d/20-pdo_mysql.ini"
 msgstr ""
 
-#: ../../../_source/cloud-libre-is.rst:158
+#: ../../../_source/cloud-libre-is.rst:159
 msgid "Then restart apache..."
 msgstr ""
 
 #: ../../../_source/cloud-libre-is.rst:166
-msgid "Nextcloud"
+msgid "redis"
 msgstr ""
 
 #: ../../../_source/cloud-libre-is.rst:167
-msgid "Get Nextcloud source."
+msgid "Make some redis config changes. Edit /etc/redis/redis.conf"
 msgstr ""
 
-#: ../../../_source/cloud-libre-is.rst:181
+#: ../../../_source/cloud-libre-is.rst:176
-msgid "Apache More"
+msgid "Then restart redis."
-msgstr ""
-
-#: ../../../_source/cloud-libre-is.rst:182
-msgid "Set up Apache for nextcloud."
 msgstr ""
 
 #: ../../../_source/cloud-libre-is.rst:184
+msgid "Nextcloud"
+msgstr ""
+
+#: ../../../_source/cloud-libre-is.rst:185
+msgid "Get Nextcloud source."
+msgstr ""
+
+#: ../../../_source/cloud-libre-is.rst:199
+msgid "Apache More"
+msgstr ""
+
+#: ../../../_source/cloud-libre-is.rst:200
+msgid "Set up Apache for nextcloud."
+msgstr ""
+
+#: ../../../_source/cloud-libre-is.rst:202
 msgid "Remove the old configs:"
 msgstr ""
 
-#: ../../../_source/cloud-libre-is.rst:191
+#: ../../../_source/cloud-libre-is.rst:209
 msgid ""
 "Then add file /etc/apache2/sites-available/cloud-libre-is.conf with these "
 "contents:"
 msgstr ""
 
-#: ../../../_source/cloud-libre-is.rst:230
+#: ../../../_source/cloud-libre-is.rst:248
 msgid "Symlink it to enable it, then restart apache."
 msgstr ""
 
-#: ../../../_source/cloud-libre-is.rst:241
+#: ../../../_source/cloud-libre-is.rst:259
 msgid "Nextcloud Admin"
 msgstr ""
 
-#: ../../../_source/cloud-libre-is.rst:242
+#: ../../../_source/cloud-libre-is.rst:260
 msgid "Now go to the new site and configure via web browser:"
 msgstr ""
 
-#: ../../../_source/cloud-libre-is.rst:247
+#: ../../../_source/cloud-libre-is.rst:264
-msgid "Config changes:"
+msgid "Create an admin account with password."
 msgstr ""
 
-#: ../../../_source/cloud-libre-is.rst:254
+#: ../../../_source/cloud-libre-is.rst:266
-msgid "Update config:"
+msgid "Settings:"
 msgstr ""
 
-#: ../../../_source/cloud-libre-is.rst:260
+#: ../../../_source/cloud-libre-is.rst:268
+msgid "Database: nextcloud"
+msgstr ""
+
+#: ../../../_source/cloud-libre-is.rst:269
+msgid "Database user: nextcloud"
+msgstr ""
+
+#: ../../../_source/cloud-libre-is.rst:270
+msgid "Database password: password used when creating nextcloud db above."
+msgstr ""
+
+#: ../../../_source/cloud-libre-is.rst:271
+msgid ""
+"Install recommended apps. After installing apps, it appears to hang at the "
+"dashboard with just a big white box. Clicking outside the box fixes it."
+msgstr ""
+
+#: ../../../_source/cloud-libre-is.rst:273
+msgid "Click in upper right corner icon and go to \"Administration Settings\"."
+msgstr ""
+
+#: ../../../_source/cloud-libre-is.rst:276
+msgid ""
+"Make some config changes. Edit /var/www/html/nextcloud/config/config.php and "
+"add under \"'installed' => true,\" this:"
+msgstr ""
+
+#: ../../../_source/cloud-libre-is.rst:309
+msgid "Note, memcache.distributed is borken."
+msgstr ""
+
+#: ../../../_source/cloud-libre-is.rst:311
+msgid ""
+"Edit /etc/php/8.2/apache2/php.ini and /etc/php/8.2/fpm/php.ini in the "
+"[opcache] section, set these values then restart apache:"
+msgstr ""
+
+#: ../../../_source/cloud-libre-is.rst:329
+msgid ""
+"Update config. The config script needs a wrapper to run from the command "
+"line. Create /usr/local/sbin/nextcloud-occ with these contents:"
+msgstr ""
+
+#: ../../../_source/cloud-libre-is.rst:337
+msgid "Then make it executable:"
+msgstr ""
+
+#: ../../../_source/cloud-libre-is.rst:345
+msgid "Run OCC updates:"
+msgstr ""
+
+#: ../../../_source/cloud-libre-is.rst:354
 msgid "Background jobs:"
 msgstr ""
 
-#: ../../../_source/cloud-libre-is.rst:262
+#: ../../../_source/cloud-libre-is.rst:356
 msgid ""
 "`<https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/"
 "background_jobs_configuration.html>`_"
 msgstr ""
 
-#: ../../../_source/cloud-libre-is.rst:264
+#: ../../../_source/cloud-libre-is.rst:358
 msgid "FPM config:"
 msgstr ""
 
-#: ../../../_source/cloud-libre-is.rst:266
+#: ../../../_source/cloud-libre-is.rst:360
 msgid ""
 "`<https://docs.nextcloud.com/server/latest/admin_manual/installation/"
 "source_installation.html>`_ `<https://www.php.net/manual/en/install.fpm."
 "php>`_"
 msgstr ""
+
+#: ../../../_source/cloud-libre-is.rst:364
+msgid "Move the install log out of the way:"
+msgstr ""