Skip to main content

FAQ

Can I change the brand name?

Yes. Update lib/config/site.ts, replace assets, and adjust page copy where needed.

Can I use Sonata for a client?

No. Sonata is licensed for one individual, company, or organization to use for their own hosting website. If a client wants to use Sonata for their hosting brand, they need their own valid license.

Can I sell websites made with Sonata?

No. Sonata is not licensed for selling finished websites, client websites, or website-building services based on Sonata. You may modify Sonata freely for your own licensed individual, company, or organization website, but you may not resell Sonata, sell a modified copy, or use it as a base for client work.

Can I add more products?

Yes. Add product data in:
Then update or create the relevant page.

Can I use another billing panel?

Yes. Update billing URLs and query parameters. For game hosting, check the billing config in game-hosting.ts.

Can I remove anti-piracy markers?

No. License markers, download identifiers, and anti-piracy placeholders must not be removed or tampered with.

Can I publish my modified version publicly?

No, not as source code, a reusable template, or a redistributed product. You may deploy the finished website or app as part of a licensed project.

Can I make Sonata dark mode only?

Yes, but review the theme toggle and html.light tokens if removing light mode support.

Can I use the docs on another site?

Yes. These MDX files are intended to be portable for an external docs site.

Where do I update colors?

Use:

Where do I update SEO?

Use:

Where do I update pricing?

Use:

Do I need Pterodactyl?

No. Sonata can be used without Pterodactyl. Pterodactyl is only needed if you want live stock or infrastructure data connected to the included stock API flow.

Do I need UptimeRobot?

No. UptimeRobot is optional. If you do not use it, remove or customize the status page content to match your monitoring provider.

Can I use Cloudflare?

Yes. You can use Cloudflare for DNS, CDN, caching, SSL, and basic protection. Make sure API routes that need fresh data are not cached incorrectly.

Can I deploy to Vercel?

Yes. Vercel is one of the easiest deployment targets for Sonata. Add production environment variables in the Vercel project settings before deploying.

Can I deploy to a VPS?

Yes. Build Sonata with pnpm build, run it with pnpm start, then place it behind a reverse proxy such as Nginx.

Why does it work locally but fail in production?

Common causes:
  • Missing production environment variables.
  • Case-sensitive path issues on Linux.
  • Old Node.js version.
  • Build command mismatch.
  • External API requests blocked or rate-limited.
  • Placeholder billing URLs.

Can I add a new page?

Yes. Add the page under app/, then update navigation and footer if customers need to access it easily.

Can I change the design system?

Yes. Start with app/globals.css and shared components. Avoid rewriting every page unless the brand direction is completely different.

Should I edit components or data files?

Edit data files for content, pricing, specs, products, and URLs. Edit components when you need to change layout, interaction, or visual behavior.
Last modified on May 13, 2026