NEXTCLOUD(1)

📦
version 3.16.7 · 5 versions
, in debian trixie

💖 NEXTCLOUD(1) — Nextcloud Client Manual 💖

okay so bestie, welcome to the Nextcloud manual page, section 1 of 3 (yes there's more, we're not done yet, stay with me 🫶). This is the manual name btw — it's nextcloud, page 1, from the Nextcloud Client Manual. Iconic. Let's get into it.

✨ NAME ✨

nextcloud — File synchronisation desktop utility. That's it, that's the whole vibe. 💅

🌸 SYNOPSIS 🌸

nextcloud [OPTIONS...]

🦋 DESCRIPTION 🦋

So the Nextcloud Client is a file synchronization desktop utility, no cap. What it does is sync files on your local computer, tablet, or handheld device with a Nextcloud Server. And here's the slay part: if you make a change to the files on one device, that change gets propagated to all the other synchronized devices using the desktop synchronization clients. Automatic. Effortless. Main character energy fr fr. ✨

Normally, you start the client by clicking on the desktop icon, or by starting it from the client application menu. Either way works, no stress. After starting, a Nextcloud icon appears in the computer system tray — or on your tablet or handheld device. And then you just… vibe. 🎀

👑 OPTIONS 👑

You have the option of starting your Nextcloud desktop client with the nextcloud command. The following options are supported:

  • nextcloud -h or nextcloud --help — Displays all command options. Your little cheat sheet, your map, your bestie. 🗺️

The other options are:

  • --logwindow — Opens a window displaying log output. Like a little reality TV feed for your logs 📺
  • --logfile <filename> — Write log output to the file specified. And if you wanna write to stdout instead? Just specify - as the filename. Yes really, just a lil dash. 💅
  • --logdir <name> — Writes each synchronization log output in a new file in the specified directory. One log per sync, each one getting its own little file moment. 🌸
  • --logexpire <hours> — Removes logs older than the value specified (in hours). Note that this command is used with --logdir — they're a duo, don't split them up. 🫶
  • --logflush — Clears (flushes) the log file after each write action. Clean girl aesthetic. ✨
  • --logdebug — Also output debug-level messages in the log. This is equivalent to setting the env var QT_LOGGING_RULES="qt.*=true;*.debug=true". Same energy, different delivery. 🐛
  • --confdir <dirname> — Uses the specified configuration directory. Pick your own home for your config, we love a custom setup. 💜
  • --background — Launch the application in the background (i.e. without opening the main dialog). Stealth mode, lowkey, no window popping up to interrupt you. 🧚

🍓 CONFIG FILE 🍓

The Nextcloud Client reads a configuration file. You can locate this configuration file as follows:

  • On Linux distributions:
$HOME/.config/Nextcloud/nextcloud.cfg
  • On Microsoft Windows systems:
%APPDATA%\Nextcloud\nextcloud.cfg
  • On macOS systems:
$HOME/Library/Preferences/Nextcloud/nextcloud.cfg

The configuration file contains settings using the Microsoft Windows .ini file format. And you can overwrite changes using the Nextcloud configuration dialog. Options, options, options. 😌

NOTE: Use caution when making changes to the Nextcloud Client configuration file. Incorrect settings can produce unintended results. For real though — messing with config files is not the moment to freestyle. Read before you type, bestie. 💀

more parts coming, don't go anywhere 👀

Some interesting values that can be set on the configuration file are:

✨ [Nextcloud] section ✨

Okay bestie, first up is the [Nextcloud] section. These are the settings that make your Nextcloud client go brrr:

  • remotePollInterval — default 30000. Specifies the poll time for the remote repository in milliseconds. ⏱️
  • forceSyncInterval — default 7200000. The duration of no activity after which a synchronization run shall be triggered automatically. 🔄
  • fullLocalDiscoveryInterval — default 3600000. The interval after which the next synchronization will perform a full local discovery. 🔍
  • notificationRefreshInterval — default 300000. Specifies the default interval of checking for new server notifications in milliseconds. 🔔

✨ [General] section ✨

And now the [General] section — the main character of config settings, no cap:

  • chunkSize — default 10000000 (10 MB). Specifies the chunk size of uploaded files in bytes. The client will dynamically adjust this size within the maximum and minimum bounds (see below). 📦
  • forceLoginV2 — default false. If the client should force the new login flow, even though some circumstances might need the old flow. 🔐
  • minChunkSize — default 5000000 (5 MB). Specifies the minimum chunk size of uploaded files in bytes. 🔽
  • maxChunkSize — default 5000000000 (5000 MB). Specifies the maximum chunk size of uploaded files in bytes. 🔼
  • targetChunkUploadDuration — default 60000 (1 minute). Target duration in milliseconds for chunk uploads. The client adjusts the chunk size until each chunk upload takes approximately this long. Set to 0 to disable dynamic chunk sizing. ⏳
  • promptDeleteAllFiles — default false. If a UI prompt should ask for confirmation if it was detected that all files and folders were deleted. 🗑️
  • timeout — default 300. The timeout for network connections in seconds. ⏲️
  • moveToTrash — default false. If non-locally deleted files should be moved to trash instead of deleting them completely. 🚮
  • showExperimentalOptions — default false. Whether to show experimental options that are still undergoing testing in the user interface. Turning this on does not enable experimental behavior on its own. It does enable user interface options that can be used to opt in to experimental features. 🧪
  • showMainDialogAsNormalWindow — default is false 🌸 whether the main dialog should be shown as a normal window, like, even if tray icons are available. So if you want the window to be a whole window and not a little tray ghostie, you set this to true. slay.

🌈 [Proxy] section 🌈

okay bestie, this whole section is about how the client gets out to the internet when there's a proxy in the way. Three variables, that's it, that's the section 💅

  • host — default: 127.0.0.1 — the address of the proxy server. like, where the proxy lives.
  • port — default: 8080 — the port were the proxy is listening. (yes the manpage says "were", and I am not fixing it, I am a woman of integrity ✨ it means where.)
  • type — default: 2 — and this one is a little picker, so here's the menu 🎀
    • 0 for System Proxy. let the system handle it, main character energy.
    • 1 for SOCKS5 Proxy.
    • 2 for No Proxy. (this is the default, so if you do nothing, nothing happens, iconic behaviour honestly)
    • 3 for HTTP(S) Proxy.
fr fr, type is a number and the numbers mean very different things, so don't just vibe-check it and guess. 0 and 2 are not the same and 1 and 3 are not the same. 🙈

🐛 BUGS 🐛

Found a bug? Do not suffer in silence, bestie. Please report bugs at https://github.com/nextcloud/client/issues. The devs want to know. Go tell them. It's giving community. 🫶

👀 SEE ALSO 👀

  • nextcloudcmd(1) — the command-line sibling, for when you want the same energy but in a terminal. iykyk 💜

✍️ AUTHOR ✍️

The Nextcloud developers 👑

2013-2024, The Nextcloud developers

and that's the whole page, bestie!! this was NEXTCLOUD(1) from version 3.16, dated Nov 02, 2025, written by the Nextcloud developers and lovingly screamed into the group chat by me. go forth and sync responsibly. no cap. 🦋💖✨

📦 where this page comes from