Nextcloud Desktop Client

The Nextcloud Desktop Client is a tool to synchronize files from Nextcloud Server with your computer.

🚀 Releases

For the latest stable recommended version, please refer to the download page https://nextcloud.com/install/#install-clients

Contributing to the desktop client

✌️ Please read the 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 master 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 building the client on macOS we have a tool called mac-crafter. You will find more information about it in its dedicated README.

1. 🚀 Set up your local development environment

Note

Find the system requirements and instructions on how to work on Windows with KDE Craft on our desktop client blueprints repository.

1.1 System requirements

• Windows 10, Windows 11, macOS 10.14 Mojave (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

1.2 Optional

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

Tip

We highly recommend Nextcloud development environment on Docker Compose for testing/bug fixing/development.
▶️ https://juliusknorr.github.io/nextcloud-docker-dev/

1.3 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 :

mkdir <build directory>

3. Compile:

cd <build directory>
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.

4. Build it:

• Windows:

cmake --build .

• Other platforms:

make

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

Get in touch 💬

• 📋 Forum
• 👥 Facebook
• 🐣 Twitter
• 🐘 Mastodon

You can also get support for Nextcloud!

📜 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.