Skip to main content
migration guideInvoice Ninja alternativeself-hosted invoicingrecord keeping

Switching from Invoice Ninja: Hosted and Self-Hosted Exits

How to leave Invoice Ninja cleanly: CSV reports vs the full backup, shutting down a self-hosted server, auto-billed clients, credits and number patterns.

InvoiceQuickly Team··Updated ·11 min read

Leaving Invoice Ninja is unusual because you may own the server. A hosted user closes an account; a self-hosted user also decides what happens to a database, a domain and every client portal link already sitting in clients' inboxes. This guide covers both cases with steps from Invoice Ninja's own documentation, then the honest question of whether to switch at all and to what.

Should you leave Invoice Ninja at all?

Most people leave for one of three reasons. Each points to a different answer.

Reason for leavingLowest-effort answerChanges tool?
Maintaining a self-hosted server (updates, backups, PHP and database upgrades)Move to Invoice Ninja's hosted service and keep the same data modelNo
Hosted plan costCheck whether the hosted Free plan covers you: Invoice Ninja's pricing page lists a Free plan for up to 5 clients with unlimited invoices; Pro is $14 a month for one user (as of October 2026)Maybe not
Want a simpler invoicing-only toolMove to a dedicated invoicing tool and accept fewer featuresYes

Invoice Ninja does more than most invoicing tools: time tracking, expenses, projects, many payment gateways, an API and, on higher plans, multiple companies and Peppol e-invoicing. If you use those, a smaller tool is a downgrade. The rest of this guide assumes you are changing tools, but Steps 1 and 2 are worth doing even if you only move from self-hosted to hosted.

Step 1: Export the CSV reports

Invoice Ninja's Reports screen is the portable export. Its documentation lists record types including Clients, Invoices, Invoice Items (which also covers invoiced tasks), Payments, Credits, Quotes, Recurring Invoices, Expenses and Products, plus special reports such as Aged Receivable, Customer Balance and Tax Summary (Invoice Ninja docs, "Reports").

ReportWhat to setWhy
ClientsCustomize Columns: add contact email, address, VAT/tax number, custom fieldsRe-creating clients in the new tool
InvoicesRange: all timeYour invoice register with status and balance
Invoice ItemsRange: all timeLine-level detail, including billed tasks
Payments and CreditsRange: all timeMatching cash and unapplied credits
Recurring InvoicesCurrentThe schedules you must rebuild
Aged Receivable and Customer BalanceAs of the switch dateYour list of money still owed
Tax SummaryEach tax year you still needEvidence for returns

Three tips from the same documentation: the Export button downloads every row whether or not you filtered; Send Email with Attach Documents also emails a ZIP of documents attached to the records; and if Excel asks about leading zeros, choose Don't Convert so invoice and client numbers keep their format.

Step 2: Take the full backup as well

Invoice Ninja documents full system backups and restores under Settings → Backup | Restore, with the backup emailed to you (Invoice Ninja docs, "Import and export"). This file is built for restoring into Invoice Ninja, not for loading into another product, so treat it as insurance: it is what lets you rebuild the account if an auditor or client queries something the CSV reports did not capture.

If you self-host, also take your own server-level backup of the database and the application's stored files before changing anything. Invoice Ninja forum users report that the in-app backup may not include uploaded documents, so do not rely on it alone.

Step 3: Decide what happens to the server or hosted account

Self-hosted. Your invoices, PDFs and client portal are served from your own domain. Every invoice email you have sent contains a link back to that server. If you shut it down, clients lose access to past invoices and receipts. A sensible order:

  1. Keep the instance running, with updates applied, until all open invoices are paid.
  2. Send each active client a final statement or a PDF of their open invoices, so they do not depend on the portal.
  3. Once your records are exported and the backup is tested, either keep a locked-down copy offline for your retention period or shut it down.

Hosted. Export before you downgrade or cancel, and do not assume the account stays readable. If you have 5 clients or fewer, Invoice Ninja's hosted Free plan may let you keep the old account open as an archive at no cost; confirm the current limits on its pricing page first.

Either way, keep the exported files for as long as your tax authority requires. In the US, the IRS generally asks for 3 years, and up to 7 in some cases (IRS, "How long should I keep records?"); UK companies keep records for 6 years (GOV.UK). Our record-keeping guide covers storage. This is general information, not tax advice; check with your tax authority or adviser. Last reviewed: October 2026.

Step 4: Stop auto-billing and settle open balances

Invoice Ninja's recurring invoices can charge a client's saved payment method automatically: auto-bill can be Enabled, Opt-In, Opt-Out or Disabled (Invoice Ninja docs, "Recurring invoices"). The saved card or bank account sits with the payment gateway you connected, such as Stripe or GoCardless, and is used by Invoice Ninja. It does not transfer to a new invoicing tool.

  1. Filter Recurring Invoices to Active and note the client, amount, frequency, remaining cycles and auto-bill setting of each.
  2. After the last cycle Invoice Ninja should bill, press Stop on each. Invoice Ninja marks it Paused and creates no further invoices.
  3. Tell auto-billed clients that automatic payment ends and how they will pay from the next invoice.
  4. Run Aged Receivable and Customer Balance. Collect open invoices in Invoice Ninja, where they were issued.
  5. For unapplied client credits, either apply them to final Invoice Ninja invoices or agree a refund. If a credit must carry over, record it in writing and show it on the first new invoice.

Worked example (illustrative): a web developer self-hosts Invoice Ninja with 9 monthly hosting retainers on auto-bill. They stop all 9 after the 1 March run, email the clients on 2 March, and issue April invoices from the new tool with a payment link. One client has a $120 credit from a cancelled add-on; it is applied to that client's March invoice before the switch, so nothing carries over.

Step 5: Keep invoice numbers unique

Invoice Ninja's Generated Numbers settings let you build numbers from a pattern (for example year plus counter), use a prefix, share the counter between quotes and invoices, enable separate client numbering, and reset counters on a schedule (Invoice Ninja docs, "Invoice Settings"). Two of those options can produce repeated numbers over time: a counter reset without the year in the pattern, and per-client counters.

  1. Check your Invoices export for duplicate numbers.
  2. Pick a prefix in the new tool that no Invoice Ninja pattern used.
  3. Record the switch date and both schemes with your records.

In InvoiceQuickly you set the prefix and the next number in Settings. Numbers are generated automatically as PREFIX-0001, with one invoice counter per account. New estimates use their own EST- counter and credit notes their own CN- counter; historical gaps remain. There is no per-client or yearly-reset pattern. More in invoice numbering systems.

Step 6: Replace your payment gateways

Invoice Ninja connects many gateways, including Stripe, PayPal, Square and GoCardless. Before switching, list which gateways your clients actually pay through, because a smaller tool may not support them.

InvoiceQuickly Pro supports two: Stripe and PayPal, each connected with your own account keys. If you already use Stripe or PayPal with Invoice Ninja, you can connect the same account, so payouts keep going to the same bank. Each InvoiceQuickly payment link charges the invoice's remaining balance on the provider's hosted page, and payments are recorded when the provider confirms them. Square, GoCardless and other gateways are not available, so clients who paid that way need another method, such as bank transfer recorded manually.

What changes if you move to InvoiceQuickly

InvoiceQuickly is a hosted invoicing tool with a narrower scope than Invoice Ninja. Compare it honestly against what you use today:

You use in Invoice NinjaIn InvoiceQuickly
Self-hosting, your own databaseNo. Hosted only; no self-host option
CSV importNo client or invoice import; clients are added by hand
Full data exportInvoice CSV on Pro plus per-invoice PDFs; no full-account export in the app
Recurring invoices with auto-billRecurring schedules on Pro (one line item, the saved tax and discount rates, saved payment terms (30 days by default), not editable after creation); no auto-bill
Many gatewaysStripe and PayPal only, on Pro
Time tracking, expenses, projectsYes, on Pro: a timer or manual time entries, expenses and projects, billed into a draft invoice you review
Multiple companiesNo, one business per account
Peppol e-invoicing, APINo Peppol e-invoicing; a public API with scoped keys on Pro, with no outbound webhooks
Client portal, estimates, credit notesYes, on Pro
AI drafting from a typed or spoken descriptionYes; Free includes 3 drafts, Pro is unlimited
PriceFree: 5 invoices in total and 5 clients; Pro: $9/month, 5 seats

Setup time (a calculation, not a timed test): 15 minutes for business details and numbering, plus 2 minutes per client typed from your Clients CSV, plus 3 minutes per recurring schedule. With 25 clients and 9 schedules: 15 + 50 + 27 = 92 minutes.

When InvoiceQuickly is the wrong destination

Do not move to InvoiceQuickly if data control is why you self-host: it is a hosted service, it does not publish a self-host option, and account deletion or a full export currently means emailing the team. It is also the wrong fit if clients rely on auto-bill, if you need Square or GoCardless, if you run several companies, or if you must send Peppol e-invoices. In those cases, staying on Invoice Ninja (hosted or self-hosted) or comparing other tools in our Invoice Ninja alternatives roundup and Invoice Ninja vs Wave makes more sense. For the direct comparison, see InvoiceQuickly vs Invoice Ninja.

Frequently asked questions

How do I export all my data from Invoice Ninja?

Use Reports to export CSV files for clients, invoices, invoice items, payments, credits, quotes and recurring invoices, and run a full backup from Settings → Backup | Restore. The CSVs are readable anywhere; the backup is for restoring into Invoice Ninja.

Can I import an Invoice Ninja export into InvoiceQuickly?

No. InvoiceQuickly has no Invoice Ninja or client import. Keep your Invoice Ninja exports as the archive and add the clients you still bill by hand.

They stop working, because the portal is served from your server. Send clients PDFs or a final statement before you shut it down, and keep your own copies.

Do auto-bill payment methods move to a new tool?

No. Saved payment methods are held by the gateway you connected and used by Invoice Ninja's auto-bill. Stop the recurring invoices and ask clients to pay new invoices through the new payment link or method.

Is it easier to move from self-hosted to hosted Invoice Ninja?

Usually, because the data model stays the same and Invoice Ninja documents full backup and restore. Ask Invoice Ninja support to confirm the current process for your version before you start.

Is my data safer self-hosted or hosted?

It depends on who maintains it. Self-hosting gives you control but makes you responsible for updates and backups; a hosted service moves that work to the provider. Decide based on your legal requirements and who will patch the server.

Next step

Export the CSV reports and run the backup today, then stop auto-billed recurring invoices on your chosen switch date. If a hosted invoicing tool with a narrower scope fits, you can start on the free plan. For a fuller feature list, see the features page; for more guides, browse the InvoiceQuickly blog.

Editorial team
InvoiceQuickly Team

Practical guidance for freelancers and small businesses creating and managing invoices.

Invoicing best practices for freelancers and SMBsInvoice workflowsAI-assisted invoice draftingSmall business operations

Create your next invoice from one prompt

Describe the client, work, prices, and payment terms. Review every field before you send.

Create a Free Invoice

Related guides

Useful, occasional notes

Get invoicing tips that actually help

Join the InvoiceQuickly update list for practical invoicing advice and product news.

No spam, ever. Unsubscribe anytime.