Skip to main content

Deployment

This page summarizes how to host Iqonga: the platform on demo.iqonga.org and the information site on iqonga.org.

Overview​

SitePurposeContent
demo.iqonga.orgPlatformFull app (frontend + backend). Login, dashboard, agents, workflows, channels.
www.iqonga.org / iqonga.orgInformation siteStatic info only (no app, no login). What the platform is, links to docs, GitHub, demo.

demo.iqonga.org (platform)​

  • Code: On server at e.g. /var/www/demo.iqonga.org/ (backend + frontend).
  • Build frontend: cd frontend && npm ci && npm run build. Output is frontend/dist/.
  • Run backend: e.g. with PM2: pm2 start backend/src/server.js --name iqonga-api (from repo root), or run on port 3001.
  • Nginx: Root = frontend/dist; proxy /api/ and /uploads/ to http://127.0.0.1:3001.

Enable site:

sudo cp docs/deployment/nginx-demo.iqonga.org.conf /etc/nginx/sites-available/demo.iqonga.org.conf
sudo ln -s /etc/nginx/sites-available/demo.iqonga.org.conf /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx

Env: Set VITE_API_URL=https://demo.iqonga.org/api when building the frontend for production.

www.iqonga.org (information site)​

  • Content: Static site in repo under info-site/ (index.html + assets).
  • Deploy: Upload contents of info-site/ to the server; Nginx serves that root.

Use Let's Encrypt for each domain:

sudo certbot --nginx -d demo.iqonga.org
sudo certbot --nginx -d www.iqonga.org -d iqonga.org

Then reload Nginx.

Documentation site (this site)​

To deploy this Docusaurus docs site:

cd docs-site
npm ci
npm run build

Output is in build/. Serve that directory with Nginx (or deploy to Vercel/Netlify/GitHub Pages by connecting the repo and setting the build directory to docs-site and build command to npm run build).