Emberly DocsSelf-Hosting
Host your own instance of Emberly — the open-source file sharing platform.
Emberly is fully open source. You can self-host your own instance with full control over storage, authentication, and domain configuration.
Development Setup
Get the development environment running locally.
Cloudflare Setup
Configure Cloudflare for custom domain SSL provisioning.
Contributing
How to contribute code, fixes, and improvements.
Overview
The Emberly platform consists of:
| Component | Technology | Description |
|---|---|---|
| Web application | Next.js 15, React 18 | Main app, API routes, dashboard |
| Database | PostgreSQL via Prisma | Users, files metadata, domains |
| Cache / Queue | Redis | Chunked upload sessions, caching |
| File storage | S3-compatible (AWS, Tigris, R2, MinIO) | Actual file storage |
| Authentication | NextAuth.js | OAuth (GitHub, Discord, Google) + credentials |
| Resend or SMTP | Transactional emails | |
| CDN / Custom domains | Cloudflare SSL-for-SaaS | Custom hostname SSL (optional) |
Minimum Requirements
- Node.js 18+
- PostgreSQL 14+
- Redis 7+
- S3-compatible object storage
- A Cloudflare zone (for custom domain features — optional)
Source Code
Emberly is hosted on GitHub: EmberlyOSS/Emberly