PixelflareThe self-hosted CDN

Deploy your own Imgur alternative on Cloudflare

Why Pixelflare?

Our goal was to build a high-performance, free/cost-effective, self-hosted image CDN that anyone can deploy and use very easily

Existing image hosting solutions have some issues

😔 Free services compress and delete images
😔 Commercial CDNs are expensive and inflexible
😔 S3-style storage lacks transformations and UX
😔 Self-hosted options require complex infrastructure

Pixelflare was built to fix these

☺️ Permanent image hosting
☺️ Super-fast global CDN delivery
☺️ Automatic transformations
☺️ Nice clean web UI

But we went further, to make it the most complete self-hosted image CDN solution available...

Built-in editor

Image Resizing

Multi-format

Lightening fast

Smart caching

Custom domains

Embed anywhere

Short URLs

Public API

Bulk upload

Powerful organization

Image meta

Built-in editor

Image classification

Auto-alt text

Scheduled backups

Real-time stats

Usage controls

Status monitor

Audit log

Encrypted pictures

Bot protection

SSO login

Privacy-respecting

Documented

Tested

Fully automated

Neat code

Dark mode

Multi-language

Accessible

Mobile-first

Recycle bin

Open source

Free / cheap

Easy migration

Quick Start

bash

# Fork and clone
git clone https://github.com/lissy93/pixelflare.git
cd pixelflare

# Install dependencies
pnpm install

# Setup environment
pnpm setup
# Then, edit .env with your CF credentials and config

# Start dev server
pnpm dev

# Run tests
pnpm test

# Deploy 
pnpm deploy

Full deployment guide →

Documentation Contents

▶ Deploy

▶ Config

AI Classification

Configure AI-powered image classification

Configure Cloudflare Analytics

Configure API keys and authentication

Configure audit logging

Configure Cloudflare for SaaS custom domains

GitHub Authentication

Configure GitHub OAuth via Cloudflare Access

Image Transformations

Configure on-the-fly image resizing and optimization

Configure application logging

Configure Cloudflare Queues for async processing

Configure API rate limits

Turnstile Configuration

Add Cloudflare Turnstile bot protection

Configure per-user storage and bandwidth limits

How to check logs for different Pixelflare components

Automated CI/CD deployment

Step-by-step manual deployment guide

Deploy Pixelflare in under 30 minutes

Terraform Setup

Deploy Pixelflare infrastructure with Terraform

Troubleshooting

Common deployment issues and solutions

▶ Develop

System architecture and design decisions

How to contribute to Pixelflare

Deployment Workflow

How deployment works

Using error utilities in Pixelflare

CI/CD workflows

Run Pixelflare locally for development

Using structured logging

Security best practices

Running and writing tests

Input validation with Zod

▶ Legal

Acceptable Use Policy

Guidelines for appropriate use of Pixelflare

How Pixelflare uses cookies

Copyright & DMCA Policy

Copyright infringement reporting and DMCA procedures

Pixelflare is released under the MIT License

How Pixelflare collects, uses, and protects your data

Security Policy

Security practices and responsible disclosure

Self-Hosted Terms

Terms for operators of self-hosted Pixelflare instances

Terms of Service

Terms and conditions for using Pixelflare

▶ Overview

How Pixelflare compares to other image hosting solutions

Frequently asked questions about Pixelflare

Explore everything Pixelflare has to offer

Why Pixelflare exists

▶ Usage

▶ Ui

View image and bandwidth analytics

Configuring image metadata and options

Managing images in the web interface

Organizing images with albums, tags, and favorites

Searching and filtering images

User settings and preferences

Uploading images via the web interface

Pixelflare REST API documentation

How to embed images in your website

Data Management

Backup, restore, and manage your data