The Nextcloud Desktop Client is a tool to synchronize files from Nextcloud Server with your computer.
For the latest stable recommended version, please refer to the download page https://nextcloud.com/install/#install-clients
✌️ 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.
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! 😍
Download and install the client:
🔽 All releases
🔽 Daily master builds
If you find any bugs or have any suggestion for improvement, please open an issue in this repository.
Tip
For contributors on macOS, there is an Xcode workspace prepared for development. See the dedicated documentation for further information.
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.
Also, please note the README in the NextcloudIntegration project which provides an even more convenient way to work on and build the desktop client on macOS by using Xcode.
Note
Find the system requirements and instructions on how to work on Windows with KDE Craft on our desktop client blueprints repository.
- 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
- Xcode (only on macOS)
Optional recommendations:
Step by step instructions on how to build the client to contribute.
- Clone the Github repository:
git clone https://github.com/nextcloud/desktop.git - Create build directory:
mkdir <build directory> - Navigate into build directory:
cd <build directory> - 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:
- 🐛 Pick a good first issue
- 👩🔧 Create a branch and make your changes. Remember to sign off your commits using
git commit -sm "Your commit message" - ⬆ Create a pull request and
@mentionthe people from the issue to eview - 👍 Fix things that come up during a review
- 🎉 Wait for it to get merged!
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 \
nextcloudThis simple test server already suffices in the most cases. For more advanced server test deployments we also recommend Nextcloud development environment on Docker Compose.
You can also get support for Nextcloud!
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.