cdn.hackclub.com

Deep under the waves and storms there lies a vault...

Banner illustration by @maxwofford.

A Rails 8 application for hosting and managing CDN uploads, with OAuth authentication via Hack Club.

• Ruby 3.4.4 (see .ruby-version)
• PostgreSQL
• Node.js + Yarn (for Vite frontend)
• A Cloudflare R2 bucket (or S3-compatible storage)

1. Clone and install dependencies:

   git clone https://github.com/hackclub/cdn.git
   
   cd cdn
   bundle install
   yarn installll

2. Configure environment variables:

   cp .env.example .env

   Edit .env with your credentials (see below for details).

3. Setup the database:

   bin/rails db:create db:migrate

4. Generate encryption keys (for API key encryption):

   # Generate a 32-byte hex key for Lockbox
   ruby -e  "require 'securerandom'; puts SecureRandom.hex(32)"
   
   
   # Generate a 32-byte hex key for BlindIndex
   ruby -e  "require 'securerandom'; puts SecureRandom.hex(32)"
   
   
   # Generate Active Record encryption keys
   bin/rails db:encryption:initt

5. Start the development servers:

   # In one terminal, run the Vite dev server:
   bin/vite dev
   
   
   
   # In another terminal, run the Rails server:
   bin/rails serverr

See .env.example for the full list. Key variables:

The API uses bearer token authentication. Create an API key from the web dashboard after logging in.

Upload a file:

curl -X POST https://cdn.hackclub.com/api/v4/upload \
  -H  "Authorization: Bearer YOUR_API_KEY" \
  -F  "[email protected]"

Upload from URL:

curl -X POST https://cdn.hackclub.com/api/v4/upload_from_url \
  -H  "Authorization: Bearer YOUR_API_KEY" \
  -H  "Content-Type: application/json" \
  -d  '{"url": "https://example.com/image.png"}'

See /docs in the running app for full API documentation.

• Rails 8 with Vite for frontend assets
• Phlex + Primer ViewComponents for UI
• Active Storage with Cloudflare R2 backend
• Solid Queue/Cache/Cable for background jobs and caching (production)
• Pundit for authorization
• Lockbox + BlindIndex for API key encryption