# Install Nextcloud on Mac (macOS)

# Installing Nextcloud on Mac (macOS)

1. Go to[ Nextcloud.com ](https://nextcloud.com)
2. Along the top of the page go to "Get Nextcloud", then click "Desktop & Mobile Apps"  
    [![image.png](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/scaled-1680-/L4xpT1oMxRVC3xNy-image.png)](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/L4xpT1oMxRVC3xNy-image.png)
3. Scroll down to "Download For Desktop", click the drop arrow, then click "macOS 10.14+, 64 bit" [![image.png](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/scaled-1680-/vWj4CbHX4zQXdi5S-image.png)](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/vWj4CbHX4zQXdi5S-image.png)
4. A file should start downloading, once downloaded open the file. [![image.png](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/scaled-1680-/Kdz19IYmikJAHaew-image.png)](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/Kdz19IYmikJAHaew-image.png)
5. You should be greeted by the Nextcloud installer, click continue [![image.png](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/scaled-1680-/LAw5cdFikk0CBHYp-image.png)](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/LAw5cdFikk0CBHYp-image.png)
6. Click Install [![image.png](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/scaled-1680-/WFryVVOhRU8sfiJv-image.png)](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/WFryVVOhRU8sfiJv-image.png)
7. A popup should appear asking for permission to install Nextcloud, please enter your device's password and click "Install Software" [![image.png](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/scaled-1680-/hahEYmAvx6TcjR9T-image.png)](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/hahEYmAvx6TcjR9T-image.png)
8. Nextcloud should now be installed, click the "Close" button. [![image.png](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/scaled-1680-/KoUUrjed5lyusfSk-image.png)](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/KoUUrjed5lyusfSk-image.png)
9. A pop up should appear asking if you would like to move the Nextcloud installer to the bin, click "Move to Bin" [![image.png](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/scaled-1680-/U16wBacWzcW72wZ7-image.png)](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/U16wBacWzcW72wZ7-image.png)
10. Go to your programs and open "Nextcloud" [![image.png](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/scaled-1680-/lHfofkM2L5v11pIL-image.png)](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/lHfofkM2L5v11pIL-image.png)
11. Nextcloud should now open, a pop up in the corner should ask for permission for notifications, click allow [![image.png](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/scaled-1680-/7bGShCWu9OYBwfiA-image.png)](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/7bGShCWu9OYBwfiA-image.png)
12. Click "Log in" [![image.png](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/scaled-1680-/2UaCfS7ZKa3mQUGw-image.png)](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/2UaCfS7ZKa3mQUGw-image.png)
13. In the "Server address" box, type in "https://files.sinorrah.co.uk", then click "Next" [![image.png](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/scaled-1680-/lMbPuk9IZNdUj7Tm-image.png)](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/lMbPuk9IZNdUj7Tm-image.png)
14. A web browser should open asking you to "Connect to your account", click "Log in" [![image.png](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/scaled-1680-/dty2Ww3vyYWXWTBu-image.png)](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/dty2Ww3vyYWXWTBu-image.png)
15. You should now be greeted with a login page, please put your email in the "Account name or Email" box, then put your password in the "Password" box, then click "Log in" [![image.png](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/scaled-1680-/HeYUQYM3MzLZyTWK-image.png)](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/HeYUQYM3MzLZyTWK-image.png)
16. If the account details are correct you should get to this screen, click "Grant Access" [![image.png](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/scaled-1680-/TYFjxHx6GbSgcI3j-image.png)](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/TYFjxHx6GbSgcI3j-image.png)
17. You should now see "Account connected", Nextcloud should reopen soon after
18. Make sure both "Ask before Syncing" are unticked, then click "Connect" [![image.png](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/scaled-1680-/vXKJAoXLctUKP5h2-image.png)](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/vXKJAoXLctUKP5h2-image.png)
19. If the Nextcloud install is successful, you should see Nextcloud pop up and start to sync your files. [![image.png](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/scaled-1680-/goWEmFLXixDeVjPP-image.png)](https://wiki.sinorrah.co.uk/uploads/images/gallery/2023-01/goWEmFLXixDeVjPP-image.png)

# Nextcloud Mac OS VFS Troubleshooting

#### Folders either empty or not syncing at all

- Remove `~/Library/Application Support/FileProvider/com.nextcloud etc` (this is where the configuration files that tell macOS to mount its providers go - Nextcloud doesn't properly clean these up when you delete the connection).
- Uninstall Nextcloud (unless you intend to re-establish some connections; if you don't uninstall it, the folder above will re-appear, albeit harmlessly with just some default entries).
- Restart your Mac (must be a restart, not a logout/in, or macOS won't let go enough for you to do the next step).
- Go to `~/Library/CloudStorage` in the Finder. Delete the folders that start with `Nextcloud` , I had to do a sudo rm -r -f to be able to do this, but this might not be needed

This will do a full reset on the VFS