Upload

File uploads — logos, attachments, and assets stored in MinIO/S3.

Run bun setup once so MinIO is up (bun docker:up). Env files come from bun setup / bun env:setup. Console: http://localhost:9001 (reloop / reloop123).

Overview

Property	Value
Directory	`apps/backend/upload`
Port	`8018`
Local URL	https://local.reloop.sh/api/upload
Swagger UI	https://local.reloop.sh/api/upload/openapi
Stack	ElysiaJS · PostgreSQL · MinIO/S3 · NATS

Quick start

bun be:upload:dev

Or bun backend:dev / bun dev.

Environment

apps/backend/upload/.env — from bun setup / bun env:setup.

PG_URL=postgresql://reloop:reloop123@localhost:5432/reloop
REDIS_URL=redis://:reloop123@localhost:6379
PORT=8018
BASE_URL="https://local.reloop.sh"
S3_ENDPOINT=http://localhost:9010
S3_ACCESS_KEY=reloop
S3_SECRET_KEY=reloop123
S3_BUCKET=reloop-uploads
S3_REGION=us-east-1
S3_FORCE_PATH_STYLE=true
NATS_URL=nats://localhost:4222
NODE_ENV=development

Variable	Required	Default
`PG_URL`	YES	`postgresql://...`
`S3_ENDPOINT`	YES	`http://localhost:9010`
`S3_ACCESS_KEY`	YES	`reloop`
`S3_SECRET_KEY`	YES	`reloop123`
`S3_BUCKET`	YES	`reloop-uploads`
`PORT`	YES	`8018`

Commands

Command	Description
`bun be:upload:dev`	Start dev server with hot reloading
`bun run --filter=be-upload build`	Compile production bundle
`bun run --filter=be-upload start`	Run compiled production build
`bun run --filter=be-upload check-types`	TypeScript type-check

Architecture

Layer	Detail
Storage	Files uploaded to MinIO locally (`localhost:9010`), S3 in production
Metadata	File index stored in Postgres (`upload` table)
Signed URLs	Generates presigned upload/download URLs for the dashboard

Setup

One-command local bootstrap

Port reference

MinIO ports 9010 / 9001

Inbox

Attachments via upload

Template

Assets used in templates

Overview

Quick start

Environment

Commands

Architecture

Next

Setup

Port reference

Inbox

Template