Help Center / Getting Started

Sandbox environments

What is this page about: How sandbox environments work in Light — creating a sandbox, what gets provisioned, the statuses a sandbox can be in, how to update or reset one, and how sandbox data and infrastructure stay fully isolated from production. Covers the setup steps, common questions, and security details.

On this page

  • What is a sandbox in Light?
  • Creating a sandbox
  • Sandbox statuses
  • Managing sandboxes
  • Frequently asked questions
  • Security
  • Quick reference
  • Related articles

A sandbox is a completely separate, isolated copy of the Light application where you can safely test features, run demos, or experiment with settings — without affecting your production data. It only takes a few minutes to spin one up.

What is a sandbox in Light?

Think of a sandbox like a practice mode: everything looks and works like the real thing, but nothing you do there touches your live environment. Each sandbox gets its own company, its own users, and its own data.

You can create multiple sandboxes from one production account — for example, one per prospect, partner, or testing scenario.

Creating a sandbox

Step 1: Request a sandbox

From your production Light account, go to Settings → Sandboxes and click + Create sandbox. Fill in the details:

  • Company information — company name, entity legal name, entity display name, address, city, zip code, country, VAT number, website, and description
  • Users — the people who should have access, with their name and email
  • Personal message (optional) — a custom note included in the invite email

Step 2: The sandbox gets provisioned

Behind the scenes, Light creates a brand-new company in the sandbox environment:

  • A new company is set up with the name you provided
  • Email addresses for invoices, receipts, and contracts are automatically generated (e.g., your-company-<unique-id>@invoices.sandbox.light.inc, @receipts.sandbox.light.inc, and @contracts.sandbox.light.inc)
  • A company entity is created with the address and VAT number you entered
  • The base currency is automatically chosen based on the country (e.g., USD for US, GBP for UK, DKK for Denmark, EUR for EU)
  • All listed users are created as admins in the sandbox company

Step 3: Users get invited

Once the sandbox is ready, each user receives an invite email with:

  • The name of the person who set up the sandbox
  • The company name and any personal message
  • A link to log in at https://app.sandbox.light.inc

Sandbox statuses

Every sandbox in Light moves through one of these statuses:

Status What it means
Pending The sandbox is being set up. Usually takes just a few seconds.
Active Ready to use. Users can log in and start working.
Failed Something went wrong during setup. The error is logged for the team to investigate.
Deactivated A legacy status that may still appear on older sandboxes. It is no longer something a customer can trigger.

Managing sandboxes

Once a sandbox is up and running, Light gives you a few ways to keep it in shape:

Updating a sandbox

You can update an existing sandbox at any time:

  • Change the company name, address, or other details
  • Add new users — they'll be created in the sandbox automatically
  • Remove users — anyone not in the updated list will be deactivated
  • Update existing users' information (matched by email address)

Resetting a sandbox

An active sandbox can be reset at any time. Resetting either wipes its data back to a clean state, or reloads it from the sandbox's own original source data (a fresh copy of whatever it was seeded with at creation — never a generic demo dataset). Resetting only affects the sandbox; production is never touched.

Viewing your sandboxes

You can see all sandbox environments your company has created, along with their status, creation date, who created them, and the company details.

Frequently asked questions

The most common questions customers ask about how sandboxes work in Light:

Does the sandbox automatically pull through all data from production?

Not automatically. The sandbox never syncs with production on an ongoing basis. What the sandbox contains depends on the option chosen when it is created:

  • Empty (default) — a brand-new company with a blank slate: no customers or vendors, no bank accounts, no pre-populated chart of accounts, and no invoices, bills, transactions, or historical data
  • Demo data — the sandbox is seeded with a standard demo dataset so it feels like a working company from day one
  • A copy of your own production data — the sandbox is loaded with data from your own production company. A sandbox can only be seeded with your own company's data — this is enforced for customers; only privileged Light staff can seed a sandbox from another source company, for internal purposes

In every case this is a one-time load at creation: afterwards, no data flows between production and the sandbox. If you need additional test data, it must be entered or imported manually within the sandbox environment.

Do users need to be created separately in sandbox, or do production users automatically have access?

Users must be created separately. Production users do not automatically have access to the sandbox.

Here's how it works:

  • When you create a sandbox, you provide a list of users (name and email) as part of the setup
  • These users are created as new accounts in the sandbox environment — they are completely independent from your production users
  • Each user receives an invite email with a link to log in at the sandbox URL (app.sandbox.light.inc)
  • Sandbox users log in to a separate environment from production, with their own accounts created specifically for the sandbox
  • All sandbox users are created as Company Admins by default

To add more users later, you can update the sandbox and include the new users in the list. To remove users, simply leave them out of the updated list — they will be deactivated.

In short: the person creating the sandbox decides exactly who gets access. There is no automatic bridge between production user accounts and sandbox user accounts.

Can customers use sandbox for testing while we wipe and reload production with historical data?

Yes. The sandbox environment is completely independent from production. They run on entirely separate infrastructure:

  • Separate databases — sandbox and production have their own databases in different AWS accounts
  • Separate storage — files, documents, and attachments are stored in separate S3 buckets
  • Separate message queues — all background processing runs independently
  • No shared state — there is zero overlap between sandbox and production data

This means:

  • Wiping or reloading production data has no impact on sandbox environments
  • Sandbox users can continue working normally during any production maintenance
  • Conversely, anything done in sandbox (creating test invoices, deleting test vendors, etc.) has no impact on production

The only connection between the two is a small tracking record in production that remembers which sandboxes were created and their current status. This is purely bookkeeping — no actual sandbox data flows back to production.

Security

Light secures sandbox environments at multiple levels:

  • Access control — only Company Admins in production (or Light staff) can create, update, or reset sandboxes
  • Signed communication — all requests between production and the sandbox environment are cryptographically signed to prevent unauthorized access
  • Isolation — the sandbox runs in its own AWS account with its own infrastructure. There is no way for sandbox data to leak into production or vice versa
  • Data seeding limits — customers can seed a new sandbox with an empty state, Light's built-in demo template, or a copy of their own production company's data; only privileged Light staff can seed a sandbox from another company's data

Quick reference

A fast rundown of how sandboxes behave in Light:

Question Answer
Does sandbox copy production data? Not by default — starts empty, with optional demo data or a one-time copy of your own production data
Are production users automatically in sandbox? No — users are created fresh
Can I use sandbox during production maintenance? Yes — fully independent
How many sandboxes can I create? No hard limit — create as many as needed
What currency does the sandbox use? Based on the country you choose (US = USD, UK = GBP, etc.)
How do sandbox users log in? Via invite email link to app.sandbox.light.inc
Can I add/remove users after creation? Yes — update the sandbox with the new user list
Can I reset a sandbox? Yes — wipe to a clean state, or reload from the sandbox's own original source data
Can I deactivate a sandbox? No — this is no longer a customer action. A legacy "Deactivated" status may still appear on older sandboxes, but it can't be triggered manually

Was this article helpful?

Book a demo