Skip to content

Gitea ONLYOFFICE Bridge v1.0.0

Choose a tag to compare

@NovichekLIS NovichekLIS released this 07 Jul 08:49

Gitea ONLYOFFICE Bridge v1.0.0

Initial public release of the Gitea ONLYOFFICE Bridge.

Highlights

  • Flask/Gunicorn bridge for opening Gitea repository files in ONLYOFFICE.
  • Gitea OAuth login and permission checks for edit/save flows.
  • ONLYOFFICE file proxy and callback endpoints with save-back commits.
  • Inline Gitea preview integration through custom templates and oo-gitea.js.
  • Folder ZIP download helper for repository directories.
  • Debian/Ubuntu systemd and Nginx deployment templates.
  • English installation, security, rollback, and troubleshooting documentation.

Security Notes

  • No production secrets, private hostnames, internal IPs, logs, backups, or server-specific paths are included.
  • Deployments must generate their own OAuth client secret, bridge secret, Flask session secret, and optional ONLYOFFICE JWT secret.
  • Review SECURITY.md and .env.example before deployment.

Validation

  • Python compile/import checks passed.
  • Unit tests passed for path normalization, file classification, JWT handling, health routes, signature handling, and conflict-copy behavior.
  • Dependency check and public-package secret hygiene scans passed.
  • Validated on an existing Debian/Ubuntu-style systemd + Nginx + Gitea + ONLYOFFICE stack: health endpoint, Gitea template/asset loading, inline view page generation, unauthenticated edit redirect, and folder ZIP download.