nextcloud / nextcloud/server

Add occ command to manually decrypt files

Open
#28,520 1 comment 2 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

0. Needs triage enhancement feature: encryption (server-side) feature: occ
Dominant language
PHP
Stars
36.9k
Forks
5.2k
Avg merge
2d 3h
Merged PRs (30d)
713

Description

Please use the 👍 reaction to show that you are also in favor of this feature - we are using this information to decide which features to include in upcoming Nextcloud versions. Please don't comment if you have no relevant information to add!


For backup recovery scenarios of individual files it might be useful to have a simple command that allows to decrypt a file that was encrypted through SSE by providing the file + key files + instance secret. While there is https://github.com/syseleven/nextcloud-tools it is not really suitable for such scenarios, especially with object storage as it relies on the files still being present in the data directory and is using a filecache dump.

Roeland had the idea to implement such a command a while ago that could just be used by getting all files required to some temporary location and then running such a command.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

The issue names no files, tests, or command entry point. Start by tracing Nextcloud's SSE encryption handling and existing CLI commands, then define the required file, key files, and instance secret inputs. Done means a documented command can decrypt an individual backed-up file, including files stored through object storage.

Written by the indexing model from the issue text.

Assessment

Tech stack
php
Domain
cli, security
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.