Cryptomator Documentation
Official documentation site for Cryptomator. Built with Docusaurus.
Quick Start
This repo uses pnpm (pinned via packageManager in
package.json). The easiest way to get a matching version is to enable
Corepack: corepack enable.
Opens dev server at http://localhost:8000 with live reload.
Contributing
We welcome contributions! Please read our general contributing guidelines first. The following applies specifically to this repository.
Getting Started
- Fork the repository
- Clone your fork:
git clone <your-fork-url>
- Follow the Quick Start above
Making Changes
- Documentation files are in the
docs/ folder
- Use clear, concise language
- Include screenshots or examples where helpful
- Test your changes locally before submitting
Submitting Changes
We follow git flow for contributions:
- Create a feature branch:
git checkout -b feature/improve-docs
- Make your changes and commit:
git commit -m "Improve setup instructions"
- Push to your fork:
git push origin feature/improve-docs
- Open a pull request
Note: Branch names and commit messages above are examples. Use descriptive names that reflect your actual changes.
Guidelines
- Keep content up-to-date with the latest app versions
- Use consistent formatting and style
- Break up long sections with headings and lists
- Link to related documentation when relevant
Adding or Upgrading Dependencies
pnpm-workspace.yaml sets minimumReleaseAge: 4320 (3 days). pnpm will refuse to resolve any package version younger than that — most malicious releases are detected and unpublished within hours, so the delay protects us at near-zero cost.
If you genuinely need a fresh release sooner (e.g. a security fix just published), add the specific package/version to minimumReleaseAgeExclude in pnpm-workspace.yaml and call it out in the PR description.
Routine upgrades land via Dependabot (configured in .github/dependabot.yml), which opens monthly grouped PRs for npm dependencies and GitHub Actions. Please don't run pnpm up --latest on the default branch — review the Dependabot PR instead, or open a PR with explicit version pins and a changelog link.
Structure
docs/desktop/ - Desktop app documentation
docs/android/ - Android app documentation
docs/ios/ - iOS app documentation
docs/hub/ - Cryptomator Hub documentation
docs/security/ - Encryption architecture and security details
docs/misc/ - Additional resources
Scripts
pnpm build # Build static site
pnpm serve # Serve built site locally
Other scripts can be found in package.json.
Deployment
Deployed to docs.cryptomator.org via GitHub Pages from the main branch.
License
This documentation is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License (CC-BY-SA 4.0).