File Converter

Local development

1. Copy .env.example to .env and fill in your local MariaDB credentials.
2. Install dependencies: npm install
3. Export those same DB_HOST/DB_USER/DB_PASSWORD/DB_NAME values from .env into your shell, then apply the schema with Prisma Migrate (creates the conversion_jobs table fresh, since a new local database starts empty): DATABASE_URL=$(node scripts/printDatabaseUrl.js) npx prisma migrate deploy
4. Run the API: npm start
5. Run the worker (separate terminal): npm run worker
6. Run tests: npm test (requires the same MariaDB reachable via your .env vars, exported into the shell)

Deployment on o2switch

1. Upload the project (excluding node_modules/) via SSH/Git.
2. Create/adjust .env on the server with production values (STORAGE_DIR pointing to a writable path under your account, MariaDB credentials from cPanel).
3. npm install --include=dev (never with --ignore-scripts — Puppeteer needs its postinstall step to download Chromium).
4. Configure the app in cPanel "Setup Node.js App", pointing its entry point at src/server.js. Passenger manages this process (start/stop/restart).
5. Start the worker independently of Passenger, over SSH: ./node_modules/.bin/pm2 start ecosystem.config.cjs, then pm2 save. Try pm2 startup to survive a server reboot; if that's not permitted without root on this account, fall back to a cPanel cron job every 5 minutes that runs pm2 resurrect (or checks pm2 list and restarts the app if absent) — validate which option this hosting plan actually allows once connected over SSH.
6. Add a cPanel cron job to run the cleanup script periodically, e.g. every 15 minutes: */15 * * * * cd /home/gaan6043/convert.ombrora.com-node && /home/gaan6043/nodevenv/convert.ombrora.com-node/24/bin/node src/cleanup.js > /dev/null (adjust the path and node binary location to match your actual account — check with which node over SSH).
7. ONE-TIME, before ever running prisma migrate deploy on this server: the o2switch database already has the conversion_jobs table (created by hand, before this project used Prisma), but no _prisma_migrations tracking table. Running migrate deploy first would try to CREATE TABLE conversion_jobs again and fail with a "table already exists" MySQL error, leaving Prisma's migration history stuck and needing manual recovery. Avoid that by baselining the existing table once, ever, on this server, before step 8's migrate deploy runs for the first time: DATABASE_URL=$(node scripts/printDatabaseUrl.js) npx prisma migrate resolve --applied 0_init Do not repeat this step on later deployments — after this one-time run, migrate deploy (step 8) is the correct command going forward.
8. On every subsequent deployment: pull changes, npm run deploy

Calibre

   mkdir /home/gaan6043/convert.ombrora.com-binaries
   mkdir /home/gaan6043/convert.ombrora.com-binaries/calibre
   cd /home/gaan6043/convert.ombrora.com-binaries
   wget -nv https://download.calibre-ebook.com/5.44.0/calibre-5.44.0-x86_64.txz -O calibre.txz
   
   python3 -c "                                                                                                                                                                                                                   
    import lzma, shutil                                                                                                                                                                                                            
    with lzma.open('calibre.txz') as f_in, open('calibre.tar', 'wb') as f_out:                                                                                                                                                     
      shutil.copyfileobj(f_in, f_out)                                                                                                                                                                                            
   "
   
   tar -xf calibre.tar -C calibre                                                                                                                                                                                                 
   rm calibre.txz calibre.tar
   
   ./calibre/ebook-convert --version

FFMPEG

   wget https://johnvansickle.com/ffmpeg/releases/ffmpeg-release-amd64-static.tar.xz
   
   python3 -c "
   import lzma
   import shutil
   
   with lzma.open('ffmpeg-release-amd64-static.tar.xz') as f_in:
       with open('ffmpeg-release-amd64-static.tar', 'wb') as f_out:
           shutil.copyfileobj(f_in, f_out)
   "
   
   tar -xf ffmpeg-release-amd64-static.tar
   rm ffmpeg-release-amd64-static.tar ffmpeg-release-amd64-static.tar.xz