Skip to content

Commit dd5a2c5

Browse files
cloud_server_using_nextcloud.md (#2981)
* cloud_server_using_nextcloud.md Grammar check * Update cloud_server_using_nextcloud.md * Clarify admin account setup instructions Updated instructions for creating an admin account in Nextcloud. --------- Co-authored-by: sspencerwire <[email protected]>
1 parent 3bc2fbd commit dd5a2c5

File tree

1 file changed

+25
-25
lines changed

1 file changed

+25
-25
lines changed

docs/guides/cms/cloud_server_using_nextcloud.md

Lines changed: 25 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -14,37 +14,37 @@ tags:
1414
- Server running Rocky Linux (you can install Nextcloud on any Linux distribution, but this procedure assumes you are using Rocky).
1515
- A high degree of comfort operating from the command line for installation and for configuration.
1616
- Knowledge of a command-line editor. Using `vi` for this example, but you can use your favorite editor if you have one.
17-
- This procedure covers the `.zip` file installation method. You can also install Nextcloud with a snap application.
17+
- This procedure covers the `.zip` file installation method. You can also install Nextcloud with a snap.
1818
- This procedure uses the Apache _sites enabled_ document (linked later) for directory setup.
1919
- This procedure also uses _mariadb-server_ hardening (also linked later) for database setup.
20-
- Throughout this document the assumption is that you are root, or that you can elevate privileges with `sudo`.
20+
- Throughout this document, the assumption is that you are root, or that you can elevate privileges with `sudo`.
2121
- The example domain in use here is "yourdomain.com".
2222

2323
## Introduction
2424

25-
If you are in charge of a server environment for a large (or even a small) company, you might consider using cloud applications. Doing things in the cloud can free up your own resources for other things, but there is a downside to this, and that is the loss of control of your company's data. If a compromise occurs in the cloud application, you could risk your company's data too.
25+
If you are in charge of a server environment for a large (or even a small) company, consider using cloud applications. Doing things in the cloud can free up your own resources for other tasks, but there is a downside: the loss of control over your company's data. If a compromise occurs in the cloud application, you could risk your company's data too.
2626

27-
Taking the cloud back into your own environment is a way to reclaim security of your data at the expense of your time and energy. Sometimes, this is a cost worth paying.
27+
Taking the cloud back into your own environment is a way to regain control over your data, but at the expense of your time and energy. Sometimes, this is a cost worth paying.
2828

29-
Nextcloud offers an open source cloud with security and flexibility in mind. Note that building a Nextcloud server is a good exercise, even if you opt to take your cloud off-site in the end. The following procedure deals with setting up Nextcloud on Rocky Linux.
29+
Nextcloud offers an open-source cloud platform with security and flexibility in mind. Note that building a Nextcloud server is a good exercise, even if you end up taking your cloud off-site. The following procedure deals with setting up Nextcloud on Rocky Linux.
3030

3131
## Nextcloud install
3232

3333
### Installing and configuring repositories and modules
3434

35-
For this installation, you need two repositories. You need to install the EPEL (Extra Packages for Enterprise Linux), and the Remi Repository for 10.
35+
For this installation, you need two repositories. You need to install the EPEL (Extra Packages for Enterprise Linux) and the Remi Repository for 10.
3636

3737
!!! note
3838

39-
While Rocky Linux 10 contains the minimum required PHP version of 8.3, the Remi repository contains other PHP packages necessary for Nextcloud.
39+
While Rocky Linux 10 requires PHP 8.3, the Remi repository provides additional PHP packages necessary for Nextcloud.
4040

41-
To install the EPEL run:
41+
To install the EPEL, run:
4242

4343
```bash
4444
dnf install epel-release
4545
```
4646

47-
To install the Remi repository run:
47+
To install the Remi repository, run:
4848

4949
```bash
5050
dnf install https://rpms.remirepo.net/enterprise/remi-release-10.rpm
@@ -73,13 +73,13 @@ php remi-8.4 common [d], devel, minimal
7373
Hint: [d]efault, [e]nabled, [x]disabled, [i]nstalled
7474
```
7575
76-
Use the newest PHP that Nextcloud is compatible with. At this moment this is 8.4. Enable that module with:
76+
Use the newest PHP that Nextcloud is compatible with. At this moment, this is 8.4. Enable that module with:
7777
7878
```bash
7979
dnf module enable php:remi-8.4
8080
```
8181
82-
To see how this changes the output of the module list, run the module list command again and you will see the "[e]" next to 8.3:
82+
To see how this changes the output of the module list, run the module list command again, and you will see the "[e]" next to 8.3:
8383
8484
```bash
8585
dnf module list php
@@ -93,7 +93,7 @@ php remi-8.4 [e] common [d], devel, minimal
9393
9494
### Installing packages
9595
96-
The example here uses Apache and mariadb. To install the needed packages, do the following:
96+
The example here uses Apache and MariaDB. To install the needed packages, do the following:
9797
9898
```bash
9999
dnf install httpd mariadb-server vim wget zip unzip libxml2 openssl php84-php php84-php-ctype php84-php-curl php84-php-gd php84-php-iconv php84-php-json php84-php-libxml php84-php-mbstring php84-php-openssl php84-php-posix php84-php-session php84-php-xml php84-php-zip php84-php-zlib php84-php-pdo php84-php-mysqlnd php84-php-intl php84-php-bcmath php84-php-gmp
@@ -117,7 +117,7 @@ systemctl start httpd
117117
118118
#### Create the configuration
119119
120-
In the _Prerequisites and Assumptions_ section, there was a statement that you will be using the [Apache Sites Enabled](../web/apache-sites-enabled.md) procedure for your configuration. Click over to that procedure and set up the basics there, and then return to this document to continue.
120+
In the _Prerequisites and Assumptions_ section, there was a statement that you would use the [Apache Sites Enabled](../web/apache-sites-enabled.md) procedure for your configuration. Click over to that procedure and set up the basics there, and then return to this document to continue.
121121
122122
For Nextcloud, you will need to create the following configuration file:
123123
@@ -162,7 +162,7 @@ This is where you will install your Nextcloud instance.
162162
163163
#### Configuring PHP
164164
165-
You need to set the time zone for PHP. To do this, open up `php.ini` with your text editor of choice:
165+
You need to set PHP's time zone. To do this, open up `php.ini` with your text editor of choice:
166166

167167
```bash
168168
vi /etc/opt/remi/php84/php.ini
@@ -188,7 +188,7 @@ date.timezone = "US/Central"
188188

189189
Then save and exit the `php.ini` file.
190190

191-
Note that for the sake of keeping things the same, your time zone in the `php.ini` file should match up to your machine's time zone setting. You can discover what this is by doing the following:
191+
Note that, for consistency, your time zone in the `php.ini` file should match your machine's time zone setting. You can discover what this is by doing the following:
192192
193193
```bash
194194
ls -al /etc/localtime
@@ -221,7 +221,7 @@ Again, as indicated earlier, use the setup procedure for [hardening `mariadb-ser
221221
The next few steps assume that you are remotely connected to your Nextcloud server via `ssh` with a remote console open:
222222
223223
- Navigate to the [Nextcloud website](https://nextcloud.com/).
224-
- Let your mouse hover over 'Download' which will open a drop-down menu.
224+
- Let your mouse hover over 'Download', which will open a drop-down menu.
225225
- Click 'Nextcloud server'.
226226
- Click 'Download server archive'.
227227
- Right-click 'Get ZIP file' and copy the link.
@@ -254,21 +254,21 @@ OR
254254
mv * /var/www/sub-domains/com.yourdomain.nextcloud/html/
255255
```
256256
257-
The next step is to make sure that apache owns the directory. Do this with:
257+
The next step is to make sure that Apache owns the directory. Do this with:
258258
259259
```bash
260260
chown -Rf apache.apache /var/www/sub-domains/com.yourdomain.nextcloud/html
261261
```
262262
263-
For security reasons, you also want to move the _data_ folder from inside to outside of the _DocumentRoot_. Do this with the following command:
263+
For security reasons, you also want to move the _data_ folder from inside the _DocumentRoot _ to outside it. Do this with the following command:
264264
265265
```bash
266266
mv /var/www/sub-domains/com.yourdomain.nextcloud/html/data /var/www/sub-domains/com.yourdomain.nextcloud/
267267
```
268268
269269
### Configuring Nextcloud
270270
271-
Ensure that you have your services running. If you followed the earlier steps, they should already be running. You have had several steps between those initial service starts, so restart them just to be sure:
271+
Ensure your services are running. If you followed the earlier steps, they should already be running. You have had several steps between those initial service starts, so restart them just to be sure:
272272
273273
```bash
274274
systemctl restart httpd
@@ -285,9 +285,9 @@ Assuming that you have done everything correctly so far, you should see a Nextcl
285285
286286
![nextcloud login screen](../images/nextcloud_screen.jpg)
287287
288-
There are a couple of things that you want to do differently than the defaults:
288+
There are a couple of things that you want to do differently from the defaults:
289289
290-
- At the top of the web page, where it says `Create an admin account`, set the user and password. For the sake of this example, enter `admin` and setting a strong password. Remember to save this somewhere safe (such as a password manager) so that you do not lose it. Even though you have typed into this field, ==do not hit== ++enter++ until you complete **all** the fields.
290+
- At the top of the web page, where it says `Create an admin account`, set the user and password. For the sake of this example, enter `admin` and set a strong password. Remember to save this somewhere safe (such as a password manager) so you do not lose it. Even though you have typed into this field, ==do not hit== ++enter++ until you complete **all** the fields.
291291
- Under the `Storage & database` section, change the `Data folder` location from the default document root, to where you moved the data folder earlier: `/var/www/sub-domains/com.yourdomain.nextcloud/data`.
292292
- Under the `Configure the database` section, change from `SQLite` to `MySQL/MariaDB` by clicking on that button.
293293
- Type the MariaDB root user and password that you set earlier into the `Database user` and `Database password` fields.
@@ -296,16 +296,16 @@ There are a couple of things that you want to do differently than the defaults:
296296
297297
Once you have all this, click `Finish Setup` and you should be up and running.
298298
299-
The browser window will refresh for a bit and then usually not reload the site. Enter your URL in the browser window again and you should see the default first pages.
299+
The browser window will refresh for a bit, and then usually not reload the site. Enter your URL in the browser window again, and you should see the default first page.
300300
301-
Your administrative user is already (or should be) logged in at this point, and there are several informational pages designed to get you up to speed. The "Dashboard" is what users will see when they first login. The administrative user can now create other users, install other applications, and many other tasks.
301+
Your administrative user is already logged in (or should be), and there are several informational pages to help you get up to speed. The "Dashboard" is what users will see when they first log in. The administrative user can now create other users, install other applications, and perform many different tasks.
302302
303303
The "Nextcloud Manual.pdf" file is the user manual, so that users can get familiar with what is available. The administrative user should read through or at least scan the high points of the admin manual [On the Nextcloud website](https://docs.nextcloud.com/server/21/admin_manual/)
304304
305305
## Next steps
306306
307-
At this point, do not forget that this is a server that you will be storing company data on. It is important to get it locked down with a firewall, get the [backup set up](../backup/rsnapshot_backup.md), secure the site with an [SSL](../security/generating_ssl_keys_lets_encrypt.md), and any other needed tasks to keep your data safe.
307+
At this point, do not forget that this is a server where you will store company data. It is important to lock it down with a firewall, set up [backup](../backup/rsnapshot_backup.md), secure the site with [SSL](../security/generating_ssl_keys_lets_encrypt.md), and complete any other necessary tasks to keep your data safe.
308308
309309
## Conclusions
310310
311-
You need to evaluate carefully any decision to take the company cloud in house. For those that decide that keeping company data locally is preferable over an external cloud host, Nextcloud is a good alternative.
311+
You need to carefully evaluate any decision to take the company's cloud in-house. For those who prefer keeping company data locally rather than using an external cloud host, Nextcloud is a good alternative.

0 commit comments

Comments
 (0)