SS
SnugStageUser Guide

On this page

Covers SnugStage v2.0.4 for Joomla 4, 5 & 6.

Options screen: SnugStage → Options (top-right gear icon).
Getting Started

SnugStage User Guide

A walkthrough of the SnugStage dashboard and Options screens — creating a staging copy, reviewing and syncing changes back to live, and the Pro features that lock staging down and keep you notified.

Overview

SnugStage clones your live Joomla site — database and files both — into a separate staging copy, so you can build and test changes without any risk to what your visitors see. When you're ready, SnugStage shows you exactly what's changed before anything syncs back to live, takes an automatic backup first, and lets you roll that back in one click if something isn't right.

This guide walks through the two screens you'll use day to day — the Dashboard, where you create, sync, and roll back — and the Options screen, where staging behaviour, access protection, and notifications are configured.

01 The Dashboard

This is where every staging action happens. A fresh install with no staging copy yet looks like this:

SnugStage dashboard with no staging copy yet, showing the five action tiles and empty activity log
Dashboard → no staging copy exists yet
🟢 Create staging

Clones your live site's files and database into a new staging copy.

🟠 Push staging to live

Opens the sync review — see Syncing Changes to Live.

🟣 Selective sync Pro

Pick specific tables or files to push, instead of everything.

🔴 Delete staging

Removes the staging copy and frees the disk space it used.

🔵 Roll back last sync Pro

Restores the automatic backup taken immediately before the last sync.

The Activity Log at the bottom records every create, sync, and rollback as it happens. Along the top: Options opens the settings screens covered below, Clean Cache clears Joomla's cache, and the badge on the right shows whether the site is running Free or SnugStage PRO.

02 Setting Up Staging

Before creating your first staging copy, it's worth checking the Staging tab under Options — these settings control how a copy is built and how cautious SnugStage is when syncing back.

SnugStage Options screen, Staging tab, showing table prefix, exclude from file copy, keep backups and require typed confirmation fields
Options → Staging
Staging table prefixstg_
The prefix used for staging copies of your database tables — they live in the same database as your live site, just under this prefix instead.
Exclude from file copy
One path per line, relative to your site root, to skip when copying files. cache and log folders are excluded by default — add anything else you don't want duplicated onto staging (large media libraries, third-party cache directories, etc.).
Keep backups
How many pre-sync backups SnugStage keeps before rotating the oldest ones out. Each one is a potential rollback point.
Require typed confirmation
When on, syncing to live or deleting a staging copy asks you to type a confirmation phrase first — a safeguard against a stray click on a destructive action. Recommended to leave on.

03 Syncing Changes to Live

Clicking Push staging to live never syncs blind — it opens a review first, showing exactly what SnugStage found different between staging and live before anything is touched.

Sync staging to live modal, listing changed tables and files, rows found only on live, and a typed SYNC confirmation field
Push staging to live → review before syncing
  1. Review the counts. The badges at the top show how many tables and files changed, and the list below itemises each one.
  2. Choose what syncs. On Pro, toggling "Only sync selected items" lets you tick individual tables/files rather than syncing everything staging picked up — plain full-mirror sync on Free.
  3. Check "Rows found only on live." These exist on live but not in your staging copy — either new activity on live since staging was created, or something you removed in staging. Nothing here is deleted unless you explicitly tick it.
  4. Type SYNC to confirm (if Require typed confirmation is on), then Start. SnugStage takes an automatic backup immediately before applying anything.
Tip

If a sync doesn't look right afterwards, Roll back last sync on the dashboard restores the automatic backup taken in step 4 — no need to manually re-create staging from scratch.

04 Protecting Your Staging Copy Pro

A staging copy is reachable at its own URL — the Staging Access tab under Options locks that down so it isn't left open to the public while you work.

SnugStage Options screen, Staging Access (Pro) tab, showing protect staging URL toggle, basic-auth username and password, and IP allowlist fields
Options → Staging Access (Pro)
Protect staging URL
Automatically denies public access to the staging copy, and warns if it ever becomes reachable without protection (this is the same check the live-site admin banner warns about).
Basic-auth username / password
Optional. Adds a password prompt in front of the staging site — Apache only. The password is hashed into a generated .htpasswd file; treat it like any other saved credential.
IP allowlist
One IP address or CIDR range per line. When set, only those addresses can reach the staging site — Apache only.
Free tier

These fields are visible but locked (greyed out, and "Protect staging URL" is forced off) on the Free plan — upgrading to Pro unlocks them for editing immediately, no reinstall needed.

05 Getting Notified Pro

Rather than checking the Activity Log yourself, SnugStage can tell you the moment a job finishes.

SnugStage Options screen, Notifications (Pro) tab, showing notify email and notify webhook URL fields
Options → Notifications (Pro)
Notify email
Sent a summary whenever a create, sync, delete, or rollback job finishes or fails.
Notify webhook URL
SnugStage POSTs a JSON summary here on the same events — useful for piping job results into Slack, a status page, or your own automation.

06 Licence & Permissions

Two more tabs round out the Options screen, alongside Staging, Staging Access, and Notifications:

License
Where you paste the licence key emailed to you after signing up — Free, trial, or a paid Annual/Perpetual key. Verified and locked to your domain on first activation.
Permissions
Standard Joomla ACL for the component — controls which user groups can access SnugStage's screens and actions, same as any other Joomla component's Permissions tab.

Tips & Reminders

  1. Both your live and staging admin panels show a permanent colour-coded banner at the top of every page, so it's always obvious which one you're looking at — green for live, amber for staging.
  2. If a staging copy exists and its URL isn't protected, the live-site banner will say so directly — that's your cue to visit Staging Access and turn protection on.
  3. Every new install includes a one-time, no-card 14-day trial with every Pro feature unlocked, so you can try Selective Sync, Rollback, Staging Access, and Notifications before deciding to buy.