nextcloud/desktop

Nextcloud Desktop Client

The Nextcloud Desktop Client is an app to synchronize files from Nextcloud Server with your computer available for Windows, macOS and Linux.

Downloads 🚀

For the latest stable and recommended version, please refer to the official download page.

Help 🛟

You can find the user, administration and developer manuals for the desktop client on our central documentation site.

Contributing 🫴

• Make sure to follow our guidelines for contributing to this repository.
• Don't forget to read our Code of Conduct. This document offers some guidance to ensure Nextcloud participants can cooperate effectively in a positive and inspiring atmosphere and to explain how together we can strengthen and support each other.

Join the team 👪

There are many ways to contribute, of which development is only one! Find out how to get involved, including as a translator, designer, tester, helping others, and much more! 😍

Help testing 🔬

Download and install the client:

• All releases
  
• Daily builds

Reporting issues 🐛

If you find any bugs or have any suggestion for improvement, please open an issue in this repository.

Bug fixing and development 🛠️

[!TIP] For contributors on macOS, see the macOS development guide.

[!NOTE]
Find the system requirements and instructions on how to work with KDE Craft in our desktop client blueprints repository.

System requirements

• Windows 10, Windows 11, macOS 13 Ventura (or newer) or Linux
• 🔽 Inkscape (to generate icons)
• Developer tools: cmake, clang/gcc/g++:
• Qt6 since 3.14, Qt5 for earlier versions
• OpenSSL
• 🔽 QtKeychain
• SQLite
• Xcode (only on macOS)

Optional recommendations:

• Qt Creator IDE
• delta: A viewer for git and diff output

Build

Step by step instructions on how to build the client to contribute.

1. Clone the Github repository: git clone https://github.com/nextcloud/desktop.git
2. Create build directory: mkdir <build directory>
3. Navigate into build directory: cd <build directory>
4. Compile: cmake -S <cloned desktop repo> -B build -DCMAKE_PREFIX_PATH=<dependencies> -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=. -DNEXTCLOUD_DEV=ON

[!TIP] The cmake variable NEXTCLOUD_DEV allows you to run your own build of the client while developing in parallel with an installed version of the client.

Then you might continue with these steps:

1. 🐛 Pick a good first issue
2. 👩‍🔧 Create a branch and make your changes. Remember to sign off your commits using git commit -sm "Your commit message"
3. ⬆ Create a pull request and @mention the people from the issue to eview
4. 👍 Fix things that come up during a review
5. 🎉 Wait for it to get merged!

Test servers

The easiest way to have a local Nextcloud server to develop, debug and test the client against is the Nextcloud Docker image. The following example shows how to deploy a Nextcloud Docker container on the local host which will be removed again as soon as the command is interrupted. Note that this requires Docker to be installed in your developer environment.

docker run \
    --rm \
    --publish 8080:80 \
    --env SQLITE_DATABASE=nextcloud.sqlite \
    --env NEXTCLOUD_ADMIN_USER=admin \
    --env NEXTCLOUD_ADMIN_PASSWORD=admin \
    nextcloud

This simple test server already suffices in the most cases. For more advanced server test deployments we also recommend Nextcloud development environment on Docker Compose.

Get in touch 💬

• 📋 Forum
• 🐘 Mastodon
• 🔗 LinkedIn
• 🦋 Bluesky
• 👥 Facebook

You can also get professional support for Nextcloud and the desktop client!

License 📜

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
for more details.