Installation (from the ZIP)

This is the install path for CodeCanyon buyers. Start here after you download the ZIP. Online docs stay the source of truth: docs.streamly.watch. The ZIP also includes README-FIRST.txt and install-guide.txt - read those first on disk, then follow this page. Time: ~30–60 minutes for a first local run (plus DNS/TLS when you deploy).

What you get after install

Surface	URL
Viewer storefront	`https://your-domain.com`
Operator admin	`https://your-domain.com/admin`
Viewer login	`https://your-domain.com/login`
Plans / checkout	`https://your-domain.com/pricing`

One deploy = one streaming brand. Payments, video CDNs, ads, analytics, and email are enabled later as Plugins.

Streamly does not provide copyrighted media. You must have rights to every source you attach.

Package contents

After you extract the CodeCanyon ZIP you should see:

streamly-1.0.1/             # Package root (ZIP)
├── documentation/          # Offline Mintlify docs + PDF
├── install-guide.txt       # Short install checklist
├── LICENSE.txt             # Envato Market license summary
├── README-FIRST.txt        # Read this first
└── streamly/               # Application source - open terminal HERE

Finder window showing documentation, install-guide.txt, LICENSE.txt, README-FIRST.txt, and the streamly app folder. — CodeCanyon package root - open README-FIRST.txt, then the streamly/ app folder.

Item	Purpose
`README-FIRST.txt`	Requirements, links, unpack and first login
`install-guide.txt`	Condensed step list + troubleshooting
`documentation/`	Offline Mintlify docs (same UI as hosted) + PDF
`streamly/`	Next.js app (admin + storefront + APIs + migrations)

Full tree: Folder Structure.

Requirements

Need	Notes
Node.js 20+	nodejs.org
pnpm 11	`corepack enable`
Fresh Supabase project	Do not reuse old credentials
Operator email + password	Set as `STREAMLY_INITIAL_ADMIN_EMAIL` / `STREAMLY_INITIAL_ADMIN_PASSWORD` (16+ chars in production)
TMDB API token	Server-side metadata only
Hosting	Node 20+ / Docker / Vercel or Cloudflare Workers

First operator login also needs:

Secret	Why
`STREAMLY_INITIAL_ADMIN_EMAIL`	First operator - server-only, never `NEXT_PUBLIC_`
`STREAMLY_INITIAL_ADMIN_PASSWORD`	First operator password (≥ 16 characters in production). Removable after bootstrap

Optional later: Stripe / PayPal, video plugins, ads, analytics. Details: Requirements.

Step 1 - Extract and open the app

Extract the ZIP.
Open streamly-1.0.1/streamly/ in your editor (the app folder).
Open a terminal inside that folder.

You should see package.json, .env.example, DEPLOYMENT.md, app/, supabase/migrations/, themes/, plugins/, addons/.

Step 2 - Install dependencies

corepack enable
pnpm install --frozen-lockfile

Step 3 - Create Supabase and run migrations

Create a new project at supabase.com/dashboard.
Settings → API - copy:
- Project URL → NEXT_PUBLIC_SUPABASE_URL
- anon public key → NEXT_PUBLIC_SUPABASE_ANON_KEY
- service_role key → SUPABASE_SERVICE_ROLE_KEY
SQL Editor - run every file in supabase/migrations/ in numeric / filename order.
Authentication → URL Configuration:
- Site URL = your public URL (or http://localhost:3000 locally)
- Add redirect URLs that include /auth/callback

There is no single INSTALL.sql / schema.sql. Use supabase/migrations/ only.

Guide: Supabase Configuration.

Step 4 - Environment variables

cp .env.example .env.local

Minimum:

NEXT_PUBLIC_APP_URL=http://localhost:3000
NEXT_PUBLIC_PLATFORM_HOST=localhost:3000
NEXT_PUBLIC_STREAMLY_API_BASE=http://localhost:3000/api/v1
NEXT_PUBLIC_SUPABASE_URL=https://YOUR_REF.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=...
SUPABASE_SERVICE_ROLE_KEY=...
TENANT_SECRETS_MASTER_KEY="$(openssl rand -base64 32)"
STREAMLY_CRON_SECRET="$(openssl rand -base64 32)"
STREAMLY_INITIAL_ADMIN_EMAIL=you@example.com
STREAMLY_INITIAL_ADMIN_PASSWORD=at-least-16-chars
TMDB_API_TOKEN=...

First operator bootstrap (set on the host / Vercel / Wrangler secrets):

STREAMLY_INITIAL_ADMIN_EMAIL=you@example.com
STREAMLY_INITIAL_ADMIN_PASSWORD=at-least-16-chars

These two values are server-only. Do not prefix them with NEXT_PUBLIC_. After the first operator signs in, you can remove STREAMLY_INITIAL_ADMIN_PASSWORD and redeploy. Payment and analytics keys are usually pasted later in Admin → Plugins (encrypted) - not only in .env. Full list: Environment Variables.

Step 5 - Run locally

pnpm run dev
# or: pnpm run build && pnpm run start

Open:

URL	Expect
`http://localhost:3000`	Storefront loads
`http://localhost:3000/admin/login`	Operator email + password

Streamly admin operator sign-in screen. — Operator sign-in - email and password on /admin/login.

Compare with the live demo: streamly.watch.

Open /admin/login.
Enter the email and password. On a new install these must match STREAMLY_INITIAL_ADMIN_EMAIL and STREAMLY_INITIAL_ADMIN_PASSWORD.
Finish onboarding → /admin/overview.

After the first operator exists, /api/admin/login only authenticates users already marked is_operator=true. Unknown emails cannot become operators. Public viewer signup never grants operator access.

Step 7 - Deploy (when ready)

Target	Guide
Node.js / reverse proxy	Deploy (Node)
Vercel	Deploy (Vercel)
Docker / OCI	Same page → Option B
Cloudflare Workers	Deploy Cloudflare

Also see DEPLOYMENT.md inside the app folder. After deploy, sign in on your production URL with the bootstrap operator credentials (or the existing operator password if you already completed first login).

Step 8 - First product setup

Task	Where
Apply a theme	`/admin/themes`
Logos, colors, SEO	`/admin/landing-page`
Plans	`/admin/plans`
Catalog + sources	`/admin/catalog`
Payments (optional)	`/admin/plugins` → Stripe / PayPal / Bank Transfer
Stripe webhook	`https://your-domain.com/api/webhooks/stripe`
PayPal webhook	`https://your-domain.com/api/webhooks/paypal`
Trial (optional)	Settings → Trial
Smoke test	Viewer signup → profile → play → checkout

Bank-transfer viewers stay on Free until you Approve in /admin/subscriptions. Full checklist: First Launch Checklist.

Troubleshooting

Symptom	Fix
“Operator login is not configured”	Set `STREAMLY_INITIAL_ADMIN_EMAIL` and `STREAMLY_INITIAL_ADMIN_PASSWORD` (16+ characters) and redeploy
“Invalid email or password”	First install: use the exact bootstrap credentials. After setup: use the operator’s Supabase password
“Password must be at least 16 characters”	Choose a longer password
Plans stay Free after Stripe	Confirm webhook + return URL - Billing FAQ
Bank transfer paid but Free	Approve in `/admin/subscriptions`
Catalog empty	Import titles / attach sources; check TMDB token
`/movies` redirects to login	Expected - catalog routes need viewer auth + profile

More: Deployment FAQ, General FAQ.

Quick Start - shorter path once you know the package
Folder Structure
Requirements
Getting Support

​What you get after install

​Package contents

​Requirements

​Step 1 - Extract and open the app

​Step 2 - Install dependencies

​Step 3 - Create Supabase and run migrations

​Step 4 - Environment variables

​Step 5 - Run locally

​Step 6 - Sign in as operator

​Step 7 - Deploy (when ready)

​Step 8 - First product setup

​Troubleshooting

​Related

What you get after install

Package contents

Requirements

Step 1 - Extract and open the app

Step 2 - Install dependencies

Step 3 - Create Supabase and run migrations

Step 4 - Environment variables

Step 5 - Run locally

Step 6 - Sign in as operator

Step 7 - Deploy (when ready)

Step 8 - First product setup

Troubleshooting

Related