{"id":25480101,"url":"https://github.com/flintsh/flare","last_synced_at":"2026-03-07T22:11:33.905Z","repository":{"id":277955943,"uuid":"934023708","full_name":"FlintSH/Flare","owner":"FlintSH","description":"A modern, lightning-fast file sharing platform built for self-hosting. Created with support for ShareX, Flameshot, and easy to set up. ","archived":false,"fork":false,"pushed_at":"2025-04-03T04:59:45.000Z","size":1577,"stargazers_count":30,"open_issues_count":2,"forks_count":2,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-07T10:50:07.424Z","etag":null,"topics":["docker","file-management","file-sharing","flameshot","nextjs","nextjs15","react","self-hosted","server","sharex"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FlintSH.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"ko_fi":"FlintSH"}},"created_at":"2025-02-17T06:29:47.000Z","updated_at":"2025-04-03T14:57:25.000Z","dependencies_parsed_at":"2025-03-14T03:45:37.944Z","dependency_job_id":null,"html_url":"https://github.com/FlintSH/Flare","commit_stats":null,"previous_names":["flintsh/flare"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlintSH%2FFlare","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlintSH%2FFlare/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlintSH%2FFlare/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlintSH%2FFlare/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FlintSH","download_url":"https://codeload.github.com/FlintSH/Flare/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248068321,"owners_count":21042477,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["docker","file-management","file-sharing","flameshot","nextjs","nextjs15","react","self-hosted","server","sharex"],"created_at":"2025-02-18T15:27:25.732Z","updated_at":"2026-03-07T22:11:33.873Z","avatar_url":"https://github.com/FlintSH.png","language":"TypeScript","funding_links":["https://ko-fi.com/FlintSH","https://ko-fi.com/xnefas/"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"./public/banner.png\" alt=\"Flare Banner\" width=\"600px\" /\u003e\n  \u003cp\u003e\u003csmall\u003e\u003ci\u003eIcon designed by \u003ca href=\"https://ko-fi.com/xnefas/\"\u003exNefas\u003c/a\u003e\u003c/i\u003e\u003c/small\u003e\u003c/p\u003e\n  \n  ### A modern, lightning-fast file sharing platform built for self-hosting\n\n[![Version](https://img.shields.io/github/v/release/FlintSH/flare?include_prereleases\u0026style=flat-square\u0026logo=github)](https://github.com/FlintSH/flare/releases)\n[![Last Commit](https://img.shields.io/github/last-commit/FlintSH/flare?style=flat-square\u0026logo=git)](https://github.com/FlintSH/flare/commits/main)\n[![Stars](https://img.shields.io/github/stars/FlintSH/flare?style=flat-square\u0026logo=github)](https://github.com/FlintSH/flare/stargazers)\n[![Discord](https://img.shields.io/discord/1006668059936829511?style=flat-square\u0026color=5865F2\u0026logo=discord\u0026logoColor=white)](https://discord.gg/mwVAjKwPus)\n\n\u003c/div\u003e\nFlare is a modern, self-hostable file sharing platform designed to work seamlessly with popular screenshot and sharing tools like ShareX and Flameshot. Built with Next.js and designed with simplicity in mind, it offers a complete solution for all your file sharing needs with a strong focus on performance, customizability, and user experience.\n\n## ✨ Features\n\n- 🚀 **Universal Screenshot Integration**\n  - ShareX, Flameshot, and Bash Script support\n  - One-click configuration downloads\n- 🔒 **Secure \u0026 Private** - Role-based permissions, private files, and password protection\n- 💾 **Flexible Storage** - Local filesystem and S3-compatible storage support\n- 🖼️ **Universal Preview** - Preview images, videos, PDFs, and code with syntax highlighting\n- 🔍 **Smart Search** - Search by filename, OCR content, and date with filters\n- 📱 **Modern UI** - Clean, responsive interface built with shadcn/ui - easily customizable\n- ⚙️ **Configurable**\n  - User storage quotas, registration controls, and instance settings\n  - Theme customization with CSS variables and custom colors\n  - Advanced settings for custom CSS and HTML injection\n- 📊 **Admin Dashboard** - Usage metrics, user management, and system configuration\n- 👥 **User Management** - Role assignment, storage quotas, and content moderation\n- 🔗 **URL Shortener** - Custom short URLs under your domain with click tracking\n- 📝 **Pastebin** - Code and text sharing with syntax highlighting\n- 🤖 **OCR Processing** - Automatic text extraction from images uploaded\n- 🔌 **Rich Embeds** - Content embeds naturally on all your social media platforms.\n\n## 🚀 Quick Start\n\nFlare is quick to deploy—you only need a PostgreSQL server and Docker. Choose one of these options:\n\n### Railway (One-Click)\n\nClick the button below to deploy Flare on Railway. Once deployed, just set your authentication secret and create your admin account.\n\n[![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/template/JVT41u?referralCode=R5s8WT)\n\n### Docker Deployment (Self-Hosted)\n\n1. Set up a PostgreSQL server and create a database for Flare.\n\n2. Create a `.env` file with the following required variables:\n\n   ```bash\n   DATABASE_URL=postgresql://user:pass@host:5432/dbname # (replace with your PostgreSQL connection string)\n   NEXTAUTH_SECRET=your-secure-secret-key # (generate with `openssl rand -base64 32`)\n   NEXTAUTH_URL=http://localhost:3000 # (or wherever you deploy Flare)\n   ```\n\n3. Run Flare using the pre-built Docker image:\n\n   ```bash\n   docker run -d \\\n     --name flare \\\n     -p 3000:3000 \\\n     --env-file .env \\\n     -v ./uploads:/app/uploads \\\n     flintsh/flare:latest\n   ```\n\n4. Open http://localhost:3000 to complete the setup and create your admin account.\n\nThe official Docker image is available on Docker Hub and GitHub Container Registry as `flintsh/flare`.\n\n## 💬 Support\n\nNeed help with your instance? Join my [Discord](https://discord.gg/mwVAjKwPus) for support, discussions, and updates!\n\n## 📝 Configuration\n\nFlare is built to be really configurable. Head to `/dashboard/settings` to tweak different settings like:\n\n- Setting storage quotas and file size limits for users\n- Defining upload rules and restrictions\n- Configuring registration options and user permissions\n- Customizing the site's appearance and branding\n- Managing advanced settings like custom CSS and HTML\n\nFor more details on each setting, visit the [Docs](https://flare.fl1nt.dev) (coming soon).\n\n## 📜 License\n\nFlare is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflintsh%2Fflare","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fflintsh%2Fflare","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflintsh%2Fflare/lists"}