64-sellphi

Valuation

Generous asset valuation: $8,000,000,000. The listed price is the platform maximum; acquisition at valuation is handled by direct enquiry.

SellPhi

SellPhi

A complete Magento storefront + WordPress blog + site-wide RSS feed + admin

console, packaged for one-command install on any Linux VPS. Ships empty —

no products, no customers, no orders — and personalizes itself to your

brand at install time.

> Magento and WordPress themselves are not included in this package.

> SellPhi is the deployment and configuration layer. The installer obtains

> Magento 2 CE and WordPress from their own official sources at install time,

> and you run them under their own licenses. See "What ships" below.

Claude AI is baked in: once you supply your Anthropic API key, your admin

gets "Write description," "Draft blog post," "Reply to customer," and

"Rewrite in [tone]" buttons throughout.

Who this is for

• You want a real online store you own, not a hosted account you rent
• You have (or will rent) any Linux VPS
• You want AI helping you write copy without giving up control
• You don't want to spend a week configuring Magento

What ships

Everything below is SellPhi's own work — the layer that turns a bare VPS into

a running storefront:

• Interactive guided installer (install.sh)
• Docker Compose orchestration for the whole stack
• nginx + PHP-FPM + MariaDB configuration — the plumbing, configured and wired
• Site-wide RSS feed generator with a styled reader view
• CMS templates: featured-items fan-out, footnote with terms, share-to-a-friend
• Category skeleton: Store / Blog / Music / Art / Video / Section
• Claude AI hooks throughout the admin (bring your own API key)
• Backup + restore tooling
• Full documentation set

What does NOT ship

• Magento 2 CE. Not supplied, not redistributed. The installer fetches it

from its official source during install. It is licensed to you by Adobe under

OSL-3.0 / AFL-3.0, not by us.

• WordPress. Not supplied, not redistributed. The installer fetches it from

wordpress.org during install. It is GPL-licensed software, not ours to convey.

• Products, categories filled with items, customers, orders — that's yours to build
• Third-party creds — you enter your own during install
• Anyone else's IP or content

Nothing in your purchase conveys any right to Magento, to WordPress, or to any

other third-party component. You obtain those yourself and comply with their

licence terms. What you are buying is the deployment layer, the configuration,

the templates, the tooling, and the Claude integration.

Install

See START-HERE.txt for the three-step overview, or jump to docs/QUICKSTART.md.

Requirements

• Any Linux VPS with 2 GB RAM minimum (4 GB recommended)
• Docker + Docker Compose (the installer offers to install these for you)
• A domain pointing at the VPS's IP
• (Optional) Anthropic API key for Claude features — get one at

https://console.anthropic.com/

License

Single-site perpetual license. See LICENSE.txt.

Support

Read docs/TROUBLESHOOTING.md first — it covers 90% of what goes wrong.

For anything else, email support at the address in your purchase receipt.

Claude features

Claude features

Every AI button in your admin, what it does, what it costs.

Claude is opt-in. Without a CLAUDE_API_KEY in .env, every button still

appears but says "Add your Anthropic API key in Settings → Claude" when

clicked. Set the key and the buttons work immediately — no restart needed.

Your Anthropic account is billed directly. SellPhi never sees, stores,

or proxies your key beyond forwarding requests to Anthropic.

Model tiers

CLAUDE_MODEL_FAST runs on the cheap, quick buttons.

CLAUDE_MODEL_DEEP runs on the slower, considered ones.

Buttons

Write description

Location: Catalog → Products → any product edit page.

Runs on: CLAUDE_MODEL_FAST

What it does: Takes the product name and any tags or category context you

have, produces a 3–5 sentence description in your brand voice.

Tip: Set a "brand voice" note in Settings → Claude and it gets injected

into every description prompt.

Draft blog post

Location: WordPress editor.

Runs on: CLAUDE_MODEL_DEEP

What it does: From a title and 1–2 sentence outline, drafts a full post

(headings, body, closing paragraph) as a starting draft you edit.

Reply with Claude

Location: Sales → Communications → any customer email or contact form.

Runs on: CLAUDE_MODEL_FAST

What it does: Reads the incoming message and drafts a polite, on-brand

reply. Nothing is sent — the draft opens in your compose window to review.

Rewrite in [tone]

Location: Any CMS block, product description, or page editor.

Runs on: CLAUDE_MODEL_FAST

What it does: Highlight text, click Rewrite, pick a tone (formal /

casual / punchy / warm / technical). Get up to 3 variants side by side.

Translate

Location: Any content editor with a language selector.

Runs on: CLAUDE_MODEL_FAST

What it does: Translates selected text to the target language.

Preserves markup and links.

Category writer

Location: Catalog → Categories → any category page.

Runs on: CLAUDE_MODEL_DEEP

What it does: Writes a category intro paragraph that sits above the

product grid, based on the category name and the first 5 products in it.

Turning Claude off temporarily

To disable AI buttons without editing .env:

docker compose stop claude-proxy

To turn back on:

docker compose up -d claude-proxy

Configuration reference

Configuration reference

Every setting you can change lives in .env at the ZIP root. Anything you set

there survives future upgrades — the installer never overwrites values you've

customized.

Editing safely

# Stop the stack cleanly
docker compose down

# Edit
nano .env

# Bring it back up
docker compose up -d

Some values (DOMAIN, DB_ROOT_PASSWORD) require a restart to take effect.

Others (CLAUDE_MODEL_FAST, admin content) apply on the next request.

Variables

Site identity

Admin login

Database

Claude AI

Cost estimate on July 2026 pricing (per typical product description):

• claude-haiku-4-5 — ~$0.005
• claude-sonnet-5 — ~$0.03
• claude-opus-4-8 — ~$0.15

You can mix — use Haiku for descriptions and Opus for the blog by setting

both variables.

Payments (all optional)

Leaving all four blank drops the store into invoice / manual checkout mode.

Outgoing email (optional)

Skipping SMTP falls back to PHP mail(), which works but often lands in spam.

TLS

Advanced

Quick Start — 10 minutes to your first product

Quick Start — 10 minutes to your first product

Before you begin

• A VPS — anywhere you like. DigitalOcean, Linode, Hetzner, Vultr, OVH,

the $4/mo tier at any of them is enough to try. Ubuntu 22.04+, Debian 12+,

or any modern Linux with curl and bash works.

• A domain pointing at the VPS's public IP. Both example.com and

www.example.com should resolve.

• 10 minutes.

Install

# 1. Copy this folder onto your VPS (scp, rsync, sftp — your pick)
scp -r sellphi you@your-vps:/opt/

# 2. SSH in
ssh you@your-vps

# 3. Run the installer
cd /opt/sellphi
./install.sh

The installer asks you 6–8 questions and never runs anything without your

"yes." At any point you can answer n — it stops cleanly and tells you

exactly how to resume.

What you'll be asked

After install completes

You'll see:

Storefront:      https://your-domain.com
Admin console:   https://your-domain.com/admin
Blog:            https://your-domain.com/blog/
RSS feed:        https://your-domain.com/feed.xml

Admin login:     admin  /  <your password>

Sign in with those and you're at the empty admin.

Add your first product

1. Admin → Catalog → Products → Add Product

2. Enter a name and press Save

3. Click the [Write description] button next to the description field

— Claude fills it in from the name

4. Add a price and a quantity

5. Set Enable Product to Yes, Save

6. Visit your storefront and it's live

Point subscribers at your RSS feed

https://your-domain.com/feed.xml — Feedly, NetNewsWire, Reeder, Thunderbird,

anything that speaks RSS. The reader view is styled so anyone who opens it in a

browser sees a real page, not raw XML.

What next

• CONFIG.md — every .env variable explained
• CLAUDE-FEATURES.md — every AI button in the admin, what it does, cost estimates
• TROUBLESHOOTING.md — the common issues and the exact fix for each
• UPGRADING.md — how to move to the next version when it ships

Troubleshooting

Troubleshooting

Common issues and the exact fix.

Install script issues

"Docker not found"

The installer offers to install Docker via the official one-line script. If

you declined and want to add it later:

curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker "$USER"
newgrp docker   # or log out and back in
./install.sh

"Permission denied" running install.sh

chmod +x install.sh
./install.sh

Stopped mid-install

The installer prints the exact resume line. It will look like:

./install.sh --from-step 5

Run that.

First-boot issues

Storefront shows a Magento setup wizard

The seed didn't finish loading. Check the Magento container logs:

docker compose logs magento --tail 100

If you see a database connection error, verify .env matches what MariaDB

actually got by comparing:

grep DB_MAGENTO_PASSWORD .env
docker compose exec mariadb env | grep MARIADB

502 Bad Gateway

nginx started before Magento finished initializing. Give it 3–4 more minutes

on first boot. If it persists:

docker compose restart nginx

"Your connection is not private" (TLS warning)

If you chose TLS_MODE=letsencrypt but the domain doesn't yet resolve to the

VPS's IP, the cert request fails. Confirm DNS:

dig +short your-domain.com

Should return your VPS's public IP. If it doesn't, fix DNS at your registrar

first, then:

docker compose restart nginx

Claude buttons

"Claude is not configured"

Set CLAUDE_API_KEY in .env and restart the claude-proxy service:

docker compose up -d claude-proxy

"Invalid API key"

Test your key directly:

curl -s https://api.anthropic.com/v1/messages \
  -H "x-api-key: $CLAUDE_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-haiku-4-5","max_tokens":10,"messages":[{"role":"user","content":"hi"}]}'

If this returns an error, the key is bad — regenerate at

https://console.anthropic.com/.

Buttons are slow

Switch to a smaller model in .env:

CLAUDE_MODEL_FAST=claude-haiku-4-5

Haiku responds in ~1 second, Sonnet in ~3, Opus in ~8.

Payments

Stripe checkout returns to a blank page

Verify your webhook secret matches what Stripe shows in its dashboard under

Developers → Webhooks. Update it in .env and:

docker compose restart magento

Email

Order confirmations don't arrive

1. Check spam. PHP mail() almost always ends up there.

2. Configure a real SMTP relay in .env (Postmark, SES, Mailgun). Even the

free tier of any of them beats mail().

3. After setting SMTP vars, restart Magento:

   docker compose restart magento

Backups

Where are the backups?

Default: /var/backups/sellphi/ on the host.

ls -la /var/backups/sellphi/

Restore from a backup

./tools/backup/restore.sh /var/backups/sellphi/2026-07-12.tar.gz

Nuclear reset (start over)

Removes everything and lets you rerun ./install.sh.

docker compose down -v   # -v also removes volumes (products, orders, everything)
rm .env
./install.sh

Upgrading

Upgrading

SellPhi ships as versioned ZIPs. Upgrading is a rebase, not a

migration — your data and settings stay put, only the code changes.

Version philosophy

• Patch (0.1.0 → 0.1.1): bug fixes, safe to install without reading notes.
• Minor (0.1.0 → 0.2.0): new features, backwards compatible. Read the

changelog for what's new.

• Major (0.x.y → 1.0.0): breaking changes possible. Read migration notes,

back up first, plan a maintenance window.

The VERSION file at the ZIP root always shows the current version.

Upgrade steps

# 1. Back up first (always)
./tools/backup/backup.sh

# 2. Note your current version
cat VERSION

# 3. Download the new ZIP, extract into a new folder
tar xzf sellphi-0.2.0.tar.gz
cd sellphi-0.2.0

# 4. Copy your .env from the old install
cp ../sellphi-0.1.0/.env .

# 5. Run the upgrader (never overwrites your .env; only pulls in new keys)
./install.sh --upgrade

The --upgrade flow:

• Reads your existing .env
• Diffs against the new .env.example and asks about any newly-added keys
• Pulls the new container images
• Runs any needed database migrations inside the containers
• Restarts services

Rolling back

If a version doesn't work for you, roll back by re-installing the previous

version's ZIP and restoring the backup you made in step 1:

cd sellphi-0.1.0
./tools/backup/restore.sh /var/backups/sellphi/pre-upgrade-0.2.0.tar.gz

Getting notified of new versions

Your storefront subscribes to the SellPhi release feed automatically.

An admin notification appears in the top bar when a new version is available.

The notification links to a plain-English changelog — no forced updates,

no phone-home other than checking the release feed once a day.

This archive contains 6 documents. The complete folder ships as the product.