Skip to content

Commit aa5da6b

Browse files
docs(occ): update maintenance install reference
Assisted-by: Copilot:GPT-5.6 Signed-off-by: Josh <josh.t.richards@gmail.com>
1 parent ae1d3bc commit aa5da6b

1 file changed

Lines changed: 43 additions & 33 deletions

File tree

‎admin_manual/occ_system.rst‎

Lines changed: 43 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -885,45 +885,55 @@ These commands are only available before Nextcloud has been installed, after
885885
you have unpacked the archive and copied Nextcloud into the appropriate
886886
directories.
887887

888-
Display the available installation options::
889-
890-
sudo -E -u www-data php /var/www/nextcloud/occ maintenance:install --help
891-
Nextcloud is not installed - only a limited number of commands are available
892-
893-
Usage:
894-
maintenance:install [options]
895-
896-
Options:
897-
--database[=DATABASE] Supported database type [default: "sqlite"]
898-
--database-name[=DATABASE-NAME] Name of the database
899-
--database-host[=DATABASE-HOST] Hostname of the database [default: "localhost"]
900-
--database-port[=DATABASE-PORT] Port of the database
901-
--database-user[=DATABASE-USER] User name to connect to the database
902-
--database-pass[=DATABASE-PASS] Password of the database user
903-
--database-table-prefix[=...] Table prefix for every table in the database
904-
--admin-user[=ADMIN-USER] User name of the admin account [default: "admin"]
905-
--admin-pass[=ADMIN-PASS] Password of the admin account
906-
--data-dir[=DATA-DIR] Path to data directory [default: "/var/www/nextcloud/data"]
907-
908-
This example installs Nextcloud with a MySQL database::
909-
910-
sudo -E -u www-data php occ maintenance:install \
911-
--database mysql \
912-
--database-name nextcloud \
913-
--database-host 127.0.0.1 \
914-
--database-user nextcloud \
915-
--database-pass secret \
916-
--admin-user admin \
917-
--admin-pass password
888+
Display the available installation options:
889+
890+
.. code-block:: console
891+
892+
$ sudo -u www-data php /var/www/nextcloud/occ maintenance:install --help
893+
Nextcloud is not installed - only a limited number of commands are available
894+
895+
Usage:
896+
maintenance:install [options]
897+
898+
Options:
899+
--database[=DATABASE] Supported database type [default: "sqlite"]
900+
--database-name[=DATABASE-NAME] Name of the database
901+
--database-host[=DATABASE-HOST] Hostname of the database [default: "localhost"]
902+
--database-port[=DATABASE-PORT] Port the database is listening on
903+
--database-user[=DATABASE-USER] Login for database connection
904+
--database-pass[=DATABASE-PASS] Password of the database login
905+
--database-table-space[=DATABASE-TABLE-SPACE]
906+
Table space of the database (``oci`` only)
907+
--disable-admin-user Disable the creation of an administrator login
908+
--admin-user[=ADMIN-USER] Login for initial administrator account [default: "admin"]
909+
--admin-pass[=ADMIN-PASS] Password for initial administrator login
910+
--admin-email[=ADMIN-EMAIL] E-Mail to associate with the initial administrator login
911+
--data-dir[=DATA-DIR] Path to data directory
912+
--password-salt[=PASSWORD-SALT] Password salt; generated if not provided (ADVANCED)
913+
--server-secret[=SERVER-SECRET] Server secret; generated if not provided (ADVANCED)
914+
915+
This example installs Nextcloud with a MySQL database. ``occ`` prompts for
916+
the database and administrator passwords:
917+
918+
.. code-block:: console
919+
920+
$ sudo -u www-data php /var/www/nextcloud/occ maintenance:install \
921+
--database mysql \
922+
--database-name nextcloud \
923+
--database-host 127.0.0.1 \
924+
--database-user nextcloud \
925+
--admin-user admin
926+
What is the password to access the database with user <nextcloud>?
927+
What is the password you like to use for the admin account <admin>?
918928
Nextcloud was successfully installed
919929
920930
Supported databases:
921931

922-
* ``sqlite`` — SQLite (community edition only; not recommended for production)
932+
* ``sqlite`` — SQLite (not recommended for production usage)
923933
* ``mysql`` — MySQL or MariaDB
924934
* ``pgsql`` — PostgreSQL
925-
* ``oci`` — Oracle (Nextcloud Enterprise only)
926-
935+
* ``oci`` — Oracle; contact `Nextcloud GmbH
936+
<https://nextcloud.com/enterprise/>`_ for enterprise support
927937

928938
.. _command_line_upgrade_label:
929939

0 commit comments

Comments
 (0)