Menu

Caution

You are not reading the latest stable version of this documentation. If you want up-to-date information, please have a look at 0.3.5.x.

Nextcloud - MacOS

Initial Config

It is advised to setup your Nextcloud devices on LAN (if available) for the best experience. Once set up, Tor can be used for remote syncing, but remember that large files will likely fail or take a very long time, so it is best to use remote sync only for low-bandwidth activity, such as Calendar, Contacts, Tasks, and Notes. Streaming your music is also possible. Later in 2023, new connection options will unlock Nextcloud’s full feature-set.

Native Desktop Integration

The smoothest experience will be using direct account integration with your Mac. First head into the top-righthand menu of your Nextcloud’s WebUI and click “Apps,” then search for and install the Calendar and/or Contacts Apps if you don’t have them already (these are installed by default on the latest Nextcloud for StartOS). The steps below are adapted from the Official Nextcloud guide and updated for the latest MacOS (Ventura). Make sure you have first set up LAN access.

  1. Open the “System Settings” and select “Internet Accounts,” click “Add Account.” and then select “Add Other Account”.

macOS add account
macOS add account
  1. Select CalDAV for calendar setup or CardDAV for contacts setup. If you want to do both, you will need to return to this step after finishing the setup of the first.

Note

You will need to perform 2 individual setups, one for Calendar and one for Contacts.

macOS select account
  1. Select “Advanced” from the “Account Type” dropdown menu and fill in the following fields.

    macOS setup account
  • Username - The default user is “admin,” but this is your user within Nextcloud, so be sure it is the correct user if you have more than one

  • Password - In your Nextcloud WebUI, visit the top-right-hand menu and select “Personal Settings” -> “Security.” At the bottom, under Devices & Sessions, create a new app password with a name of your choice, such as “MacCalDAV.” Then, copy the resulting password into your Mac’s account configuration.

    nextcloud app password
  • Server Address - copy your LAN address from the “Interfaces” section of your Nextcloud service page then paste.

    nextcloud app password
  • Server Path - You can find complete path in Nextcloud -> Calendar settings -> Copy iOS/macOS CalDav address. For setting up contacts/CardDav use the same path.

    nextcloud app password
  • Port - Set port to 443.

  1. Click “Sign In.”

  • You can now select the apps you want to use on your Mac, such as Calendars, Reminders.

  • Return to Step 3 to set up CalDAV/CardDAV, whichever you have not done yet.

Standalone Clients

Note

The desktop version of NextCloud doesn’t have much of a user interface. Once installed, it solely lives in the top right hand corner of the Mac desktop in the navbar, near the WiFi icon. When it’s synced, the icon turns into a checkmark with a circle around it.

For those that prefer to use a desktop client.

File Syncing - Nextcloud Desktop

This is Nextcloud’s official client application for file syncing and account management. The latest version of the official Nextcloud client is available on their download page.

LAN Setup

Make sure you have first set up LAN access. Then do the following:

  1. Download the appropriate desktop client from the Nextcloud website.

  2. Open the client and click “Log In”.

nextcloud-login
  1. From your server’s Nextcloud Service page, go to “Interfaces” and copy the LAN address.

nextcloud-login
  1. Enter your LAN address under “Server Address” and click “Next”.

nextcloud-login
  1. This will launch a page in your web browser, click “Log In” and then “Grant access” to link the desktop client. You can close this browser window afterwards.

nextcloud-login
  1. Next, configure the local directory that you want to sync with Nextcloud. You may use the default or change it, and edit the sync settings to desired. When satisfied, click “Connect”.

nextcloud-login
  1. Files will begin to sync immediately and you will see a green check when this is complete.

nextcloud-login
  1. That’s it! From this desktop client you can receive notifications, control accounts and syncing, and quickly access your apps’ WebUI pages.

Tor Setup

You will first need to have the Tor daemon running.

  1. On your desktop application, click the account in the top left -> Settings.

nextcloud-login
  1. On the following screen, click “Network” tab and then “Specify proxy manually as” and “SOCKS5 proxy.” Enter “127.0.0.1” for the Host and “9050” for the port.

nextcloud-login
  1. Close the Settings screen and click the account in the top left again, then “Add Account.”

nextcloud-login
  1. On the following screen, click “Log in,” then enter your Nextcloud Tor server address, which you can copy from Nextcloud -> Interfaces - Tor. This must start with http:// and end with .onion. Click Next.

nextcloud-login
nextcloud-login
  1. This will launch your browser and prompt you to log in to your account. Log in and then grant access as we did for LAN.

  2. That’s it! You may wish to set up some select folders for remote sync, but for large files, it is best to sync on LAN only, so you can “Skip folders configuration” on the resulting screen if you wish. Check your connection by clicking the newly created account in the client app.