{"id":44872009,"url":"https://github.com/zextras/carbonio-docs-editor","last_synced_at":"2026-02-17T13:14:34.553Z","repository":{"id":337795305,"uuid":"590511144","full_name":"zextras/carbonio-docs-editor","owner":"zextras","description":"A Web office suite for Carbonio","archived":false,"fork":false,"pushed_at":"2026-02-11T16:30:51.000Z","size":111,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":7,"default_branch":"devel","last_synced_at":"2026-02-11T18:04:47.852Z","etag":null,"topics":["carbonio","carbonio-component","carbonio-docs","collaboration","collaboration-suite","email","email-server","oss"],"latest_commit_sha":null,"homepage":"https://zextras.com/carbonio","language":"Shell","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zextras.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-01-18T15:29:38.000Z","updated_at":"2026-02-11T09:29:34.000Z","dependencies_parsed_at":"2026-02-11T18:05:05.336Z","dependency_job_id":null,"html_url":"https://github.com/zextras/carbonio-docs-editor","commit_stats":null,"previous_names":["zextras/carbonio-docs-editor"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/zextras/carbonio-docs-editor","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zextras%2Fcarbonio-docs-editor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zextras%2Fcarbonio-docs-editor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zextras%2Fcarbonio-docs-editor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zextras%2Fcarbonio-docs-editor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zextras","download_url":"https://codeload.github.com/zextras/carbonio-docs-editor/tar.gz/refs/heads/devel","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zextras%2Fcarbonio-docs-editor/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29545342,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-17T13:00:00.370Z","status":"ssl_error","status_checked_at":"2026-02-17T12:57:14.072Z","response_time":100,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["carbonio","carbonio-component","carbonio-docs","collaboration","collaboration-suite","email","email-server","oss"],"created_at":"2026-02-17T13:14:32.026Z","updated_at":"2026-02-17T13:14:34.519Z","avatar_url":"https://github.com/zextras.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!--\nSPDX-FileCopyrightText: 2022 Zextras \u003chttps://www.zextras.com\u003e\n\nSPDX-License-Identifier: CC-BY-SA-4.0\n--\u003e\n\n# Carbonio Docs Editor\n\nA document editing service for the Carbonio suite, providing web-based office document editing powered by Collabora Online with service mesh integration.\n\n## Overview\n\nCarbonio Docs Editor is a packaging and configuration project that builds [Collabora Online](https://github.com/CollaboraOnline/online) with Zextras branding and integration patches, producing DEB and RPM packages for deployment within the Carbonio email and collaboration platform. It provides document editing functionality through a web interface and integrates with HashiCorp Consul for service discovery and management.\n\n## Components\n\n### Core Service\n\n- **Main Service**: Runs on port 10000 using Collabora Online (coolwsd)\n- **Sidecar Proxy**: Envoy-based proxy for service mesh integration\n- **Service Discovery**: Consul-based service registration and routing\n\n### Key Files\n\n- `carbonio-docs-editor`: Setup script for service configuration\n- `carbonio-docs-editor.service`: Systemd service for the main application\n- `carbonio-docs-editor-sidecar.service`: Systemd service for the Envoy sidecar\n- `carbonio-docs-routes-generator.py`: Python script for generating Consul routing configurations\n\n## Features\n\n- Document editing via web interface\n- Service mesh integration with Consul Connect\n- Automatic service discovery and routing\n- Support for multiple service instances\n- HTTP protocol support with specific path permissions\n\n## Quick Start\n\n```bash\n# See all available commands\nmake help\n\n# Build for Ubuntu 22.04 (Zextras devs with Artifactory access)\nmake build TARGET=ubuntu-jammy\n\n# Build with locally built dependencies (community contributors)\nmake build TARGET=ubuntu-jammy \\\n  THIRDS_DIR=../carbonio-thirds/artifacts \\\n  CORE_DIR=../carbonio-docs-core/artifacts\n\n# Clean build artifacts\nmake clean\n```\n\n### Prerequisites\n\n- Podman or Docker installed\n- Make\n- (Optional) Pre-built artifacts from [carbonio-thirds](https://github.com/zextras/carbonio-thirds) and [carbonio-docs-core](https://github.com/zextras/carbonio-docs-core)\n\n### Build Dependencies\n\nThis project requires packages from two sibling projects at build time:\n\n- **carbonio-thirds** — provides `carbonio-openssl` and `carbonio-poco`\n- **carbonio-docs-core** — provides `carbonio-docs-core`\n\nZextras developers with Artifactory access can build without providing these locally. Community contributors should build both projects first, then pass their artifact directories via `THIRDS_DIR` and `CORE_DIR`.\n\n### Supported Targets\n\n- `ubuntu-jammy` - Ubuntu 22.04 LTS\n- `ubuntu-noble` - Ubuntu 24.04 LTS\n- `rocky-8` - Rocky Linux 8\n- `rocky-9` - Rocky Linux 9\n\n### Configuration\n\nYou can customize the build by setting environment variables:\n\n```bash\n# Use a specific container runtime\nmake build TARGET=ubuntu-jammy CONTAINER_RUNTIME=docker\n\n# Specify dependency directories\nmake build TARGET=rocky-9 \\\n  THIRDS_DIR=../carbonio-thirds/artifacts \\\n  CORE_DIR=../carbonio-docs-core/artifacts\n```\n\n## Installation\n\nThese packages are distributed as part of the [Carbonio platform](https://zextras.com/carbonio). To install:\n\n### Ubuntu (Jammy/Noble)\n\n```bash\napt-get install \u003cpackage-name\u003e\n```\n\n### Rocky Linux (8/9)\n\n```bash\nyum install \u003cpackage-name\u003e\n```\n\n## Service Configuration\n\nThe service uses:\n\n- **Port**: 10000 for the main service\n- **Proxy Port**: 20000 for upstream connectivity\n- **Protocol**: HTTP\n- **Service ID**: Generated automatically per instance\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for information on how to contribute to this project.\n\n## License\n\nThis project is licensed under the GNU Affero General Public License v3.0 - see the [LICENSE.md](LICENSE.md) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzextras%2Fcarbonio-docs-editor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzextras%2Fcarbonio-docs-editor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzextras%2Fcarbonio-docs-editor/lists"}