mirror of
https://github.com/YunoHost/doc.git
synced 2024-09-03 20:06:26 +02:00
203 lines
10 KiB
Markdown
203 lines
10 KiB
Markdown
# <img src="/images/nextcloud_logo.png" alt="logo de Nextcloud"> Nextcloud
|
|
|
|
- [Discovering the Nextcloud environment](#EnvironmentNextcloud)
|
|
- [Useful Manipulations & Problems Encountered](#UtileManipulations)
|
|
- [Add space to Nextcloud](#AddSpace)
|
|
- [Third Party Applications](#AppsTiers)
|
|
- [Mobile and computer client software](#ClientSoftware)
|
|
- [Useful links](#UsefulLinks)
|
|
|
|
Nextcloud is a file hosting service, many applications can be installed to offer it new features such as a calendar, a directory, notes and many others (you can find some applications in the [third-party applications](#AppsTiers) part but there are many others depending on your needs).
|
|
|
|
## Discovering the Nextcloud environment <a name="EnvironmentNextcloud" href=""></a>
|
|
|
|
Due to the creation of Nextcloud, a database with third-party applications to install, this chapter will only concern the nextcloud database without added applications. More information on applications in the dedicated section or in the nextcloud application catalogue: [apps.nextcloud.com](https://apps.nextcloud.com).
|
|
Nextcloud is before a cloud service (like Seafile and others), it allows synchronization and file sharing on the Internet and between several terminals (computers, smartphone) but also with several people.
|
|
|
|
## Mobile and computer client software <a name="ClientSoftware" href=""></a>
|
|
|
|
There are client software for all platforms. You can find them on the official nextcloud website: https://nextcloud.com/install/#install-clients
|
|
|
|
## Useful Manipulations & Problems Encountered <a name="UtileManipulations" href=""></a>
|
|
|
|
### Add storage space <a name="AddSpace" href=""></a>
|
|
|
|
Solution I. allows you to add a link to a local or remote folder.
|
|
Solution II. allows to move the main storage space of nextcloud.
|
|
|
|
#### I. Add an external storage space
|
|
|
|
Parameter =>[Administration] External storage.
|
|
|
|
At the bottom of the list you can add a folder (It is possible to define a subfolder using the `folder/subfolder` convention.)
|
|
Select a storage type and specify the requested connection information.
|
|
You can restrict this folder to one or more nextcloud users with the column `Available for`.
|
|
With the gear you can allow or prohibit previewing and file sharing.
|
|
Finally click on the check mark to validate the folder.
|
|
|
|
#### II. Migrate Nextcloud data to a larger partition
|
|
|
|
**Note**: The following assumes that you have a hard disk mounted on `/media/storage`. Refer to[this article](/external_storage) to prepare your system.
|
|
|
|
**Note**: Replace `nextcloud` with the name of its instance, if you have several Nextcloud apps installed.
|
|
|
|
First turn off the web server with the command:
|
|
```bash
|
|
systemctl stop nginx
|
|
```
|
|
|
|
##### Choice of location
|
|
|
|
**Case A: Blank storage, exclusive to Nextcloud**
|
|
|
|
For the moment only root can write to it in `/media/storage`, which means that nginx and nextcloud will not be able to use it.
|
|
|
|
```bash
|
|
chown -R nextcloud:nextcloud /media/storage
|
|
chmod 775 -R /media/storage
|
|
```
|
|
|
|
**Case B: Shared storage, data already present, Nextcloud data in a subfolder**
|
|
|
|
If you want to use this disk for other applications, you can create a subfolder belonging to Nextcloud.
|
|
|
|
```bash
|
|
mkdir -p /media/storage/nextcloud_data
|
|
chown -R nextcloud /media/storage/nextcloud_data
|
|
chmod 775 -R /media/storage/nextcloud_data
|
|
```
|
|
|
|
##### Migrate data
|
|
|
|
Migrate your data to the new disk. To do this *(be patient, it can take a long time)*:
|
|
|
|
```bash
|
|
Case A: cp -ia /home/yunohost.app/nextcloud /media/storage
|
|
Case B: cp -ia /home/yunohost.app/nextcloud /media/storage/nextcloud_data
|
|
```
|
|
|
|
The `i` option allows you to ask yourself what to do if there is a file conflict, especially if you overwrite an old Owncloud or Nextcloud data folder.
|
|
To check that everything went well, compare what these two commands display (the content must be identical):
|
|
|
|
```bash
|
|
ls -la /home/yunohost.app/nextcloud
|
|
|
|
Case A: ls -al /media/storage
|
|
Case B: ls -al /media/storage/nextcloud_data/nextcloud
|
|
```
|
|
|
|
##### Configure Nextcloud
|
|
|
|
To inform Nextcloud of its new directory, modify the `/var/www/nextcloud/config/config.php` file with the command:
|
|
|
|
```bash
|
|
nano /var/www/nextcloud/config/config.php
|
|
```
|
|
|
|
Look for the line:
|
|
|
|
```bash
|
|
'datadirectory' => '/home/yunohost.app/nextcloud/data',
|
|
```
|
|
|
|
That you modify:
|
|
|
|
```bash
|
|
CASE A:'datadirectory' =>'/media/storage',
|
|
CASE B:'datadirectory' =>'/media/storage/nextcloud_data/nextcloud/data',
|
|
```
|
|
|
|
Back up with `ctrl+x` then `y` or `o` (depending on your server locale).
|
|
|
|
Restart the web server:
|
|
|
|
```bash
|
|
systemctl start nginx
|
|
```
|
|
|
|
Add the.ocdata file
|
|
```bash
|
|
CASE A: nano /media/storage/.ocdata
|
|
CASE B: nano /media/storage/nextcloud_data/nextcloud/data/.ocdata
|
|
```
|
|
Add a space to the file to be able to save it
|
|
|
|
Back up with `ctrl+x` then `y` or `o` (depending on your server locale).
|
|
|
|
Run a scan of the new directory by Nextcloud:
|
|
|
|
```bash
|
|
cd /var/www/nextcloud
|
|
sudo -u nextcloud php occ files:scan --all
|
|
```
|
|
|
|
It's over now. Now test if everything is fine, try connecting to your Nextcloud instance, upload a file, check its proper synchronization.
|
|
|
|
### Nextcloud and Cloudflare
|
|
|
|
If you use Cloudflare for your DNS, *which may be useful if you have a dynamic IP*, you will most likely have authentication problems with the Nextcloud application. On the Internet many people propose to create a rule that disables all options related to security and Cloudflare speed for the url pointing to your Nextcloud instance. Although it works, it is not the optimal solution. I propose, certainly to create a rule for the url pointing to your Nextcloud instance but to disable only 2 options. So here's how:
|
|
|
|
#### Cloudflare Page Rules
|
|
|
|
In the Cloudflare control panel select your domain and find Page Rules
|
|
the url in your address bar will look like this: https://dash.cloudflare.com/*/domain.tld/page-rules
|
|
|
|
##### Add a rule
|
|
|
|
The rule to be added must apply to the url of your Nextcloud instance either:
|
|
|
|
- `https://nextcloud.domain.tld/**` if you use a subdomain
|
|
- `https://domain.tld/nextcloud/*`` if you have deployed Nextcloud in a directory
|
|
|
|
The options to disable (Off) are:
|
|
|
|
- Rocket Loader
|
|
- Email Obfuscation
|
|
|
|
Save and clean your caches (Cloudflare, browser,...) and that's it.
|
|
|
|
## Third Party Applications <a name="AppsTiers" href=""></a>
|
|
|
|
- [Calendrier](app_nextcloud_calendar)
|
|
- [contact](app_nextcloud_contact)
|
|
- [KeeWeb](app_nextcloud_keeweb)
|
|
- [Carnet](app_nextcloud_carnet)
|
|
|
|
## Useful links <a name="UsefulLinks" href=""></a>
|
|
|
|
- Official website : [nextcloud.com](https://nextcloud.com/)
|
|
- Application catalogue for nextcloud : [apps.nextcloud.com](https://apps.nextcloud.com/)
|
|
|
|
# <img src="/images/APPLICATION_logo.svg" width="80px" alt="APPLICATION's logo"> APPLICATION
|
|
|
|
[](https://install-app.yunohost.org/?app=APPLICATION) [](https://dash.yunohost.org/appci/app/APPLICATION)
|
|
|
|
### Index
|
|
|
|
- [Configuration](#configuration)
|
|
- [Limitations with YunoHost](#limitations-with-yunohost)
|
|
- [Customer Applications](#customer-applications)
|
|
- [Useful links](#useful-links)
|
|
|
|
**General presentation of the application.** *Lorem ipsum dolor sit amet, consectetur adipiscing elit. Fusce rutrum sodales mauris eu viverra. Sed dapibus, tellus sit amet interdum condimentum, enim eros faucibus ligula, sed suscipit orci velit at felis. Etiam quam lacus, vulputate eu scelerisque ac, sollicitudin rutrum orci. Cras eu ante porttitor, laoreet odio sed, hendrerit tellus. Nulla luctus sem in arcu scelerisque cursus. Nulla ut tellus at leo porttitor tincidunt. Morbi vitae purus convallis, elementum lectus non, dignissim orci. Integer eget egestas mauris. Nunc nunc dolor, cursus in quam mollis, rutrum fermentum nibh. Aliquam molestie velit a nulla porttitor, sit amet tincidunt erat laoreet.*
|
|
|
|
## Configuration
|
|
|
|
**If the configuration of the application is not done with the admin panel of YunoHost.** *Lorem ipsum dolor sit amet, consectetur adipiscing elit. Fusce rutrum sodales mauris eu viverra. Sed dapibus, tellus sit amet interdum condimentum, enim eros faucibus ligula, sed suscipit orci velit at felis. Etiam quam lacus, vulputate eu scelerisque ac, sollicitudin rutrum orci. Cras eu ante porttitor, laoreet odio sed, hendrerit tellus. Nulla luctus sem in arcu scelerisque cursus. Nulla ut tellus at leo porttitor tincidunt. Morbi vitae purus convallis, elementum lectus non, dignissim orci. Integer eget egestas mauris. Nunc nunc dolor, cursus in quam mollis, rutrum fermentum nibh. Aliquam molestie velit a nulla porttitor, sit amet tincidunt erat laoreet.*
|
|
|
|
## Limitations with YunoHost
|
|
|
|
**Explanation of the current limitations in using the application with YunoHost.** *Lorem ipsum dolor sit amet, consectetur adipiscing elit. Fusce rutrum sodales mauris eu viverra. Sed dapibus, tellus sit amet interdum condimentum, enim eros faucibus ligula, sed suscipit orci velit at felis. Etiam quam lacus, vulputate eu scelerisque ac, sollicitudin rutrum orci. Cras eu ante porttitor, laoreet odio sed, hendrerit tellus. Nulla luctus sem in arcu scelerisque cursus. Nulla ut tellus at leo porttitor tincidunt. Morbi vitae purus convallis, elementum lectus non, dignissim orci. Integer eget egestas mauris. Nunc nunc dolor, cursus in quam mollis, rutrum fermentum nibh. Aliquam molestie velit a nulla porttitor, sit amet tincidunt erat laoreet.*
|
|
|
|
## Customer applications
|
|
|
|
| Application name | Platform | Multi-account | Other supported networks | Play Store | F-Droid | Apple Store | *Other* |
|
|
|------------------|----------|---------------|--------------------------|------------|---------|-------------|---------|
|
|
| | | | | | | | |
|
|
|
|
## Useful links
|
|
|
|
+ Website: [WEBSITE](#)
|
|
+ Official documentation: [DOCUMENTATION](#)
|
|
+ Application software repository: [github.com - YunoHost-Apps/APPLICATION](https://github.com/YunoHost-Apps/APPLICATION_ynh)
|
|
+ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/APPLICATION/issues](https://github.com/YunoHost-Apps/APPLICATION_ynh/issues)
|