Skip to content

coneshare/coneshare

Repository files navigation

Coneshare logo

Backend CI Ask DeepWiki MIT License Documentation

Coneshare

Turn your cloud storage into a secure, trackable data room.

Coneshare is an open-source, self-hosted platform that adds control, visibility, and workflow automation on top of your existing storage (Nextcloud, Google Drive, Dropbox).

Share documents securely, track engagement in real time, and trigger actions—without moving your files.

Quick Start · Docs · Live Demo · Roadmap · Forum

⭐ If this project is useful, please star the repo.

Coneshare 30s product walkthrough


How It Works

Coneshare acts as a layer on top of your storage:

  • Files stay in your storage (Nextcloud, Google Drive, Dropbox)
  • Coneshare adds:
    • Secure sharing controls
    • Document engagement tracking
    • Workflow automation

No migration. No duplication. No vendor lock-in.

Instead of asking “Did they read it?”, you’ll know exactly how your documents are used.


Why Coneshare

🔐 Control Layer

Add secure sharing on top of your storage:

  • Password protection, expiration, email verification
  • Download restrictions and dynamic watermarking

👁️ Intelligence Layer

Understand how documents are used:

  • Views, revisits, downloads
  • Page-level engagement insights

⚡ Action Layer

Turn activity into workflows:

  • Slack and webhook integrations
  • Real-time notifications and automation

🧱 Built for your infrastructure

  • Self-hosted by design
  • Works with your existing storage
  • No migration required

Integrations

Coneshare works with your existing storage:

  • Nextcloud (self-hosted)
  • Google Drive
  • Dropbox

More integrations coming soon.


Common Use Cases

📊 Fundraising / Investor Updates

Know when investors view your deck or data room—and follow up at the right moment.

💼 Sales & Deal Workflows

Track proposal engagement and prioritize high-intent prospects.

🤝 Secure External Sharing

Share sensitive documents with full control and visibility.

🏛️ Compliance & Regulated Environments

Run fully self-hosted while maintaining modern sharing workflows.


Who Is Coneshare For?

Coneshare is built for teams who:

  • Use cloud or self-hosted storage (Nextcloud, Drive, Dropbox)
  • Share sensitive documents externally
  • Need visibility into document engagement
  • Prefer self-hosted or private infrastructure

Quick Start

Choose your path first:

  • Self-hosted deployment (recommended for first-time operators):
  • Contribute to Coneshare source code:
    • Use the local source build flow below.

Source Build (Local Dev for Contributors)

Run Coneshare locally for development and contribution:

git clone git@github.com:coneshare/coneshare.git
cd coneshare
cp .env.template .env
make build
make up
make migrate

First-Run Verification Checklist

After make up and make migrate, verify the basics before configuring storage integrations:

  • Frontend is reachable at http://localhost:5173
  • API responds at http://localhost:8000/api/v1/
  • Core services are up (backend, frontend, core, redis, celery)
  • Local files are persisted under the project data/storage volumes configured by docker-compose.yml
  • Smoke test:
    • Upload one document
    • Create a share link
    • Open that link in a private/incognito window and confirm view access works

Troubleshooting First Install

  • .env and SITE_DOMAIN mismatch:
    • Confirm .env exists (copied from .env.template) and SITE_DOMAIN matches how you access the app locally.
  • Backend cannot reach core service:
    • Check service names/ports in docker-compose.yml and inspect backend/core logs for connection errors.
  • Redis/Celery issues (background jobs not running):
    • Confirm both redis and celery containers are running; then check Celery worker logs.
  • Local storage path/permission issues:
    • Verify mounted storage paths exist and are writable by container processes.
  • Where to look first:
    • Run make logs from repo root, then focus on backend, core, and celery error lines first.

Architecture

Coneshare architecture diagram

Coneshare is a multi-service stack:

  • backend/: Django + DRF API, Celery, Redis-based async tasks
  • core/: Go file service for secure file I/O
  • frontend/: React + Vite web app
  • docs/: Product and architecture documentation

Technical reference:


Contributing

Contributions are welcome. Open an issue, start a discussion, or submit a pull request.


Community


License

MIT License. See LICENSE.


Security

For security issues, contact dev@coneshare.com.