Skip to Content
Guides & TutorialsSelf-Host in 5 Minutes

Self-Host GenFeed in 5 Minutes

Get GenFeed Core running on your own infrastructure. Generate AI content with full control over models, data, and costs.

Just want to use GenFeed? GenFeed Cloud  is the fastest way to start — no setup required, all features included, free tier available.

Prerequisites

  • Node.js 18+ (or Bun)
  • MongoDB 7+
  • Redis 7+
  • At least one AI provider API key (Replicate, fal.ai, or OpenAI)

Quick Start

Clone the repository

git clone https://github.com/genfeedai/core.git cd core

Install dependencies

bun install

Configure environment

cp .env.example .env.local

Edit .env.local with your settings:

# Required MONGODB_URI=mongodb://localhost:27017/genfeed REDIS_URL=redis://localhost:6379 # AI Providers (at least one required) REPLICATE_API_TOKEN=your_token_here FAL_KEY=your_key_here # Optional PORT=3001 NODE_ENV=development

Start the server

bun run dev

Generate your first image

curl -X POST http://localhost:3001/api/generate/image \ -H "Content-Type: application/json" \ -d '{ "prompt": "A modern tech startup office, minimalist design", "model": "flux-schnell", "width": 1024, "height": 1024 }'

Docker Compose

For a production-ready setup with all dependencies:

# docker-compose.yml version: '3.8' services: genfeed: build: . ports: - "3001:3001" environment: - MONGODB_URI=mongodb://mongo:27017/genfeed - REDIS_URL=redis://redis:6379 - REPLICATE_API_TOKEN=${REPLICATE_API_TOKEN} depends_on: - mongo - redis mongo: image: mongo:7 volumes: - mongo_data:/data/db ports: - "27017:27017" redis: image: redis:7-alpine ports: - "6379:6379" volumes: mongo_data:
docker compose up -d

What’s Included

  • Image generation (Flux, SDXL, and more via Replicate/fal.ai)
  • Video generation (short-form, with captions)
  • Brand kit management
  • Job queue (BullMQ + Redis)
  • REST API
  • Webhook support

What’s NOT Included (Cloud Only)

Some features require the full GenFeed Cloud platform:

FeatureCore (OSS)Cloud
Image generationYesYes
Video generationYesYes
Brand kitsYesYes
Multi-tenancyNoYes
Publisher (auto-post to socials)NoYes
Analytics dashboardNoYes
Team collaborationNoYes
Managed infrastructureNoYes
SLA and supportNoYes

Need multi-tenancy, publishing, or analytics? Try GenFeed Cloud  — same engine, fully managed, with all the features your team needs.

Next Steps

Last updated on