Skip to content

Commit

Permalink
Added nextcloud service guides
Browse files Browse the repository at this point in the history
  • Loading branch information
stupleb committed Jul 29, 2024
1 parent 2585432 commit 45f7854
Show file tree
Hide file tree
Showing 16 changed files with 593 additions and 5 deletions.
4 changes: 2 additions & 2 deletions src/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -110,8 +110,8 @@ Welcome to the Start9 Docs! Here you will find everything you need to set up and
- [Nextcloud News](service-guides/nextcloud/nextcloud-apps/nextcloud-news.md)
- [Nextcloud Notes](service-guides/nextcloud/nextcloud-apps/nextcloud-notes.md)
- [Nextcloud Photos](service-guides/nextcloud/nextcloud-apps/nextcloud-photos.md)
- [Joplin](service-guides/nextcloud/nextcloud-apps/nextcloud-photos.md)
- [Thunderbird](service-guides/nextcloud/nextcloud-apps/nextcloud-photos.md)
- [Joplin](service-guides/nextcloud/nextcloud-apps/joplin.md)
- [Thunderbird](service-guides/nextcloud/nextcloud-apps/thunderbird.md)


### Misc Guides
Expand Down
4 changes: 2 additions & 2 deletions src/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -126,8 +126,8 @@
- [Nextcloud News](service-guides/nextcloud/nextcloud-apps/nextcloud-news.md)
- [Nextcloud Notes](service-guides/nextcloud/nextcloud-apps/nextcloud-notes.md)
- [Nextcloud Photos](service-guides/nextcloud/nextcloud-apps/nextcloud-photos.md)
- [Joplin](service-guides/nextcloud/nextcloud-apps/nextcloud-photos.md)
- [Thunderbird](service-guides/nextcloud/nextcloud-apps/nextcloud-photos.md)
- [Joplin](service-guides/nextcloud/nextcloud-apps/joplin.md)
- [Thunderbird](service-guides/nextcloud/nextcloud-apps/thunderbird.md)

# Misc Guides

Expand Down
14 changes: 14 additions & 0 deletions src/service-guides/nextcloud/nextcloud-apps/README.md
Original file line number Diff line number Diff line change
@@ -1 +1,15 @@
# Nextcloud Apps & Integrations

- [Nextcloud Bookmarks](nextcloud-bookmarks.md)
- [Nextcloud Calendar](nextcloud-calendar.md)
- [Nextcloud Contacts](nextcloud-contacts.md)
- [Nextcloud Cookbook](nextcloud-cookbook.md)
- [Nextcloud Files](nextcloud-files.md)
- [Nextcloud Maps](nextcloud-maps.md)
- [Nextcloud Memories](nextcloud-memories.md)
- [Nextcloud Music](nextcloud-music.md)
- [Nextcloud News](nextcloud-news.md)
- [Nextcloud Notes](nextcloud-notes.md)
- [Nextcloud Photos](nextcloud-photos.md)
- [Joplin](joplin.md)
- [Thunderbird](thunderbird.md)
92 changes: 92 additions & 0 deletions src/service-guides/nextcloud/nextcloud-apps/joplin.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,92 @@
# Joplin

[Joplin](https://joplinapp.org/) is an open source note-taking app. Capture your thoughts and securely access them from any device. First set up your [client devices](/service-guides/nextcloud/nextcloud-setup/), so that Nextcloud will automatically keep your notes synced.

Clients available for:

- Desktop
- Linux
- Mac
- Windows

- Mobile
- Android
- iOS

## Connecting Joplin to Nextcloud (Mac Desktop Example)

This guide will go over how to connect Joplin running on a desktop machine to your Start9 server's Nextcloud over LAN.

```admonish note
This guide assumes your Nextcloud username is "embassy," replace with your username if different.
```


You will need your device set up to connect via [LAN](/user-manual/trust-ca.md) first.

1. First go into Nextcloud on your server and click on the "Files" app icon.

![Click on Folders](../assets/joplin/joplin-setup0.png)


1. Click on the + icon, then "New folder".

![New Folder](../assets/joplin/joplin-setup1.png)


1. Create a new folder called "joplin" and click the arrow to the right.

![Joplin Directory](../assets/joplin/joplin-setup3.png)


1. Click on "Files settings" in the bottom left and copy the WebDAV link.

![Files Settings](../assets/joplin/joplin-setup4.png)


![WedDAV Link](../assets/joplin/joplin-setup5.png)


1. Open up Joplin, click on "Joplin" in the top left and click "Preferences" (on Mac).

![Preferences](../assets/joplin/joplin-setup7.png)


1. Click on "Synchronisation".

![Click on Synchronisation](../assets/joplin/joplin-setup8.png)


1. Under "Synchronisation target" select "Nextcloud", paste the WebDAV and append onto the end of it "joplin" so the entire URL should look like this (replace ``xxxx`` with your unique Nextcloud LAN address): ``https://xxxx.local/remote.php/dav/files/embassy/joplin``.

![Click on Synchronization](../assets/joplin/joplin-setup9.png)


1. Under "Nextcloud username" enter "embassy" (or your username).

1. Under "Nextcloud password" enter your password.

1. The username and password for your Nextcloud can be found in your server's UI by clicking on the Nextcloud service then clicking on "Properties".

![Select Nextcloud and enter URL](../assets/joplin/joplin-setup10.png)

![Select Nextcloud and enter URL](../assets/joplin/joplin-setup11.png)


1. Now click "Show advanced settings".

![Select Nextcloud and enter URL](../assets/joplin/joplin-setup12.png)

1. Scroll down then check the box that says "Ignore TLS certificate errors".

![Select Nextcloud and enter URL](../assets/joplin/joplin-setup13.png)


1. Now scroll back up and select "Check sychronisation configuration" and you should see the following success message:

![Select Nextcloud and enter URL](../assets/joplin/joplin-setup14.png)


1. You have now connected your Joplin client to your Start9 server's Nextcloud and your notes will sync automatically!
49 changes: 49 additions & 0 deletions src/service-guides/nextcloud/nextcloud-apps/nextcloud-bookmarks.md
Original file line number Diff line number Diff line change
@@ -1 +1,50 @@
# Nextcloud Bookmarks

[Nextcloud Bookmarks](https://apps.nextcloud.com/apps/bookmarks) is software for sorting, tagging, searching, sharing, and (most importantly) syncing your browser's bookmarks via your server. First set up your [client devices](/service-guides/nextcloud/nextcloud-setup/), so that Nextcloud will automatically keep your bookmarks synced.

Clients available for:

- Mobile
- Android

- Desktop Browsers
- Chrome
- Edge
- Firefox

## NC App Setup

1. Begin by downloading Bookmarks from your Nextcloud service's App Store (Top-right menu -> Apps).

```admonish tip
Use the "Search" function to quickly find the App you are looking for
```
1. Once installed/enabled, you will get a new icon in your top menu for "Bookmarks." Click it to get started.
- At this point you can begin adding bookmarks directly into the app, or import them from a browser. These are always available by accessing your Nextcloud from your client devices.
- The real power here is in the ability to import or sync across devices. There are several clients that can accomplish this, which can be found on the [NC Bookmarks Github Page](https://github.com/nextcloud/bookmarks#third-party-clients). For our example, and the recommended option if you click "Sync with your browser" from the Bookmarks welcome page, is [Floccus](https://floccus.org/).
1. (Optional) In the "Settings" menu in the bottom-left, you may change the Nextcloud location in which to store your bookmarks. If you change this or create a new folder, be sure to reflect this change in Floccus below.
## Browser & Mobile Setups
### Floccus (Browser & Android)
1. Download the appropriate Floccus extension for your browser or app from the App Store, F-Droid, or Play Store.
1. Open the Floccus browser extension and click "+NEW ACCOUNT", select "Nextcloud Bookmarks", and then add your server address and login via Nextcloud.
1. (Optional) Edit the folder paths if changed above and select a local folder to save bookmarks to.
1. On the final setup page, use the defaults unless you are absolutely sure what you are doing. Click "Continue" and you're ready to sync!
```admonish note
Repeat this process for any additional devices or browsers that you'd like to keep in sync.
```
31 changes: 31 additions & 0 deletions src/service-guides/nextcloud/nextcloud-apps/nextcloud-calendar.md
Original file line number Diff line number Diff line change
@@ -1 +1,32 @@
# Nextcloud Calendar

[Nextcloud Calendar](https://apps.nextcloud.com/apps/calendar) is software for managing and syncing calendars, events, and tasks between your devices. First set up your [client devices](/service-guides/nextcloud/nextcloud-setup/), so that Nextcloud will automatically keep your calendars synced.

Integrations available for:

- Mobile
- Android
- iOS

- Desktop
- Linux
- Mac
- Windows

## NC App Setup

1. On the latest Start9 Nextcloud service, Calendar is included by default. If coming from an older install, begin by downloading Calendar from your Nextcloud service's App Store (Top-right menu -> Apps).

```admonish tip
Use the "Search" function to quickly find the App you are looking for
```
1. Once installed/enabled, you will get a new icon in your top menu for "Calendar." Click it to get started.
- At this point you can begin using the Calendar right away in the web UI. All changes will be reflected in any currently synced client devices, or on any added in future.
## Client Integrations
Client integrations can all be found in the [initial setup guides](/service-guides/nextcloud/nextcloud-setup/) for your device.
31 changes: 31 additions & 0 deletions src/service-guides/nextcloud/nextcloud-apps/nextcloud-contacts.md
Original file line number Diff line number Diff line change
@@ -1 +1,32 @@
# Nextcloud Contacts

[Nextcloud Contacts](https://apps.nextcloud.com/apps/contacts) is software for managing and syncing your contacts between your devices. First set up your [client devices](/service-guides/nextcloud/nextcloud-setup/), so that Nextcloud will automatically keep your contacts synced.

Integrations available for:

- Mobile
- Android
- iOS

- Desktop
- Linux
- Mac
- Windows

## NC App Setup

1. On the latest Start9 Nextcloud service, Contacts is included by default. If coming from an older install, begin by downloading Contacts from your Nextcloud service's App Store (Top-right menu -> Apps).

```admonish tip
Use the "Search" function to quickly find the App you are looking for
```
1. Once installed/enabled, you will get a new icon in your top menu for "Contacts." There is also a quick access icon in the top-right. Click either to get started.
- At this point you can begin using your Contacts app right away in the WebUI. All changes will be reflected in any currently synced client devices, or on any added in future.
## Client Integrations
Client integrations can all be found in the [initial setup guides](/service-guides/nextcloud/nextcloud-setup/) for your device.
53 changes: 53 additions & 0 deletions src/service-guides/nextcloud/nextcloud-apps/nextcloud-cookbook.md
Original file line number Diff line number Diff line change
@@ -1 +1,54 @@
# Nextcloud Cookbook

[Nextcloud Cookbook](https://apps.nextcloud.com/apps/cookbook) is software for viewing, syncing, and organizing recipes. First set up your [client devices](/service-guides/nextcloud/nextcloud-setup/), so that Nextcloud will automatically keep your recipes synced.

Clients available for:

- Mobile
- Android
- iOS

## NC App Setup

1. Begin by downloading Cookbook from your Nextcloud service's App Store (Top-right menu -> Apps).

```admonish tip
Use the "Search" function to quickly find the App you are looking for
```
1. Once installed/enabled, you will get a new icon in your top menu for "Cookbook." Click it to get started.
1. You can now start adding recipes. Simply find a recipe online and copy the URL into the box on the left. In most cases, this will be translated into an easy-to-read recipe with ingredients and steps, and without all the distractions and junk included with most recipe pages.
```admonish tip
Tag and categorize your recipes! Basic settings are available in the bottom-left menu.
```
## Mobile Setups
### Nextcloud Cookbook (Android / iOS)
There are 2 versions of this app available on Android, and one on iOS. Check this [repository](https://github.com/nextcloud/cookbook/) for details.
1. Go to your app store of choice and install the Nextcloud Cookbook app.
1. (Android connection) You can select a previously connected Nextcloud account, or scan an app-specific QR, created under Nextcloud's main menu -> Personal Settings -> Security
1. (iOS connection) You will be prompted to enter the following:
- Server URL - get this from your server's Services -> Nextcloud -> Interfaces (LAN is recommended)
- Username - get this from your server's Services -> Nextcloud -> Properties (admin is default)
- Password - get this from your server's Services -> Nextcloud -> Properties
```admonish note
You may need to enable "self-signed certificates" for LAN. This is safe to do as you are the signer of the cert and owner of all involved hardware.
```
1. As soon as you connect and sync, you will see your Cookbook!
29 changes: 29 additions & 0 deletions src/service-guides/nextcloud/nextcloud-apps/nextcloud-files.md
Original file line number Diff line number Diff line change
@@ -1 +1,30 @@
# Nextcloud Files

Nextcloud Files is software for managing and syncing your data between your devices. In practice it functions similarly to the file explorer on your computer. Files also serves as the base storage on your server for all the other apps that may need to access your data, such as documents, multimedia, and syncing apps. This even includes data storage for other Start9 services on your server, such as Jellyfin and Start9 Pages.

Integrations available for:

- Mobile
- Android
- iOS

- Desktop
- Linux
- Mac
- Windows

## NC App Setup

1. You will find an icon in your top menu for "Files." Click here to get started.

- You can begin using your Files app right away in the web UI. All changes will be reflected in any currently synced client devices, or on any added in future.

```admonish warning
Keep in mind that if you delete a file in one location, it may be deleted across all locations!! Start with some test folders/files in order to understand how the syncing system works with your devices.
```
## Client Integrations
Client integrations can all be found in the [initial setup guides](/service-guides/nextcloud/nextcloud-setup/) for your device.
30 changes: 30 additions & 0 deletions src/service-guides/nextcloud/nextcloud-apps/nextcloud-maps.md
Original file line number Diff line number Diff line change
@@ -1 +1,31 @@
# Nextcloud Maps

[Nextcloud Maps](https://apps.nextcloud.com/apps/maps) is software for viewing and managing your places. First set up your [client devices](/service-guides/nextcloud/nextcloud-setup/), so that Nextcloud will automatically keep your maps synced.

No clients available at this time.

## NC App Setup

1. Begin by downloading Maps from your Nextcloud service's App Store (Top-right menu -> Apps).

```admonish tip
Use the "Search" function to quickly find the App you are looking for
```
1. Once installed/enabled, you will get a new icon in your top menu for "Maps." Click it to get started.
1. You can now browse [OpenStreetMap](https://www.openstreetmap.org/), get directions, create favorite locations, add photos, and share custom maps.
```admonish tip
You can find the settings for Maps in the bottom-left
```
```admonish note
This is basic software at this time, havnig just reached 1.0, but features are planned by the developers for linking mobile devices for finding a lost or stolen device as well as fitness tracking and other modern location services.
```
Loading

0 comments on commit 45f7854

Please sign in to comment.