Ryan Malloy
e92b7f8700
Because cats have 9 lives, but servers don't - so they need backup-restore! Complete backup solution with S3/MinIO support. - Full WordPress backup (files + database) - S3 / MinIO / S3-compatible storage backends - Scheduled automatic backups - Disaster recovery / one-click restore - Backup integrity validation - Cat-themed admin interface Includes build.sh and .distignore for WordPress-installable release ZIPs.
196 lines
7.4 KiB
Markdown
196 lines
7.4 KiB
Markdown
# 🐱 User Guide: Territory Settings - TigerStyle Life9 Complete
|
|
|
|
**Welcome to your backup territory!** This guide helps you navigate the newly organized Territory Settings page like a confident cat exploring new terrain.
|
|
|
|
## 🗺️ Page Overview
|
|
|
|
Your Territory Settings page is now organized for maximum efficiency:
|
|
|
|
```
|
|
⚙️ Territory Settings
|
|
│
|
|
├── 🐱 Welcome Message
|
|
├── 📊 Territory Status (NEW POSITION!)
|
|
├── 🕐 Automated Backup Scheduling
|
|
└── ☁️ S3/MinIO Storage Configuration
|
|
```
|
|
|
|
## 📊 Territory Status (Your New Command Center)
|
|
|
|
**Location:** Top of the page, right after the welcome message
|
|
**Purpose:** Instant overview of your backup system health
|
|
|
|
### What You'll See
|
|
|
|
#### 🔄 Automated Backups Status
|
|
- **⏸️ Disabled**: Automated backups are turned off
|
|
- **✅ Enabled**: Shows frequency (Daily/Weekly/Monthly)
|
|
- **⏰ Next backup**: When enabled, shows when your next backup will run
|
|
|
|
#### ☁️ Cloud Storage Status
|
|
- **💾 Local storage only**: Backups saved on your server only
|
|
- **✅ Configured**: Connected to S3/MinIO with bucket name shown
|
|
|
|
#### 🗄️ WordPress Cron Status
|
|
- **✅ Active**: WordPress scheduler is working (good!)
|
|
- **❌ Disabled**: WordPress cron disabled in wp-config.php (needs attention)
|
|
|
|
### 📸 Example Territory Status Display
|
|
|
|
```
|
|
📊 Territory Status
|
|
┌─────────────────────────────────────────────────┐
|
|
│ 🔄 Automated Backups: ✅ Enabled 📅 Daily │
|
|
│ ⏰ Next backup: Sep 18, 2025 02:00 AM │
|
|
│ ☁️ Cloud Storage: ✅ Configured 🪣 my-backups │
|
|
│ 🗄️ WordPress Cron: ✅ Active │
|
|
└─────────────────────────────────────────────────┘
|
|
```
|
|
|
|
## 🕐 Automated Backup Scheduling
|
|
|
|
Configure when and how often your backups run automatically.
|
|
|
|
### Settings Available
|
|
|
|
#### 🔄 Enable Automated Backups
|
|
- **Checkbox**: Turn automatic backups on/off
|
|
- **When enabled**: All other scheduling options become active
|
|
|
|
#### 📅 Backup Frequency
|
|
- **🌅 Daily**: Backup every day at specified time
|
|
- **📅 Weekly**: Backup once per week on chosen day
|
|
- **📆 Monthly**: Backup once per month on chosen date
|
|
|
|
#### 🕒 Backup Time
|
|
- **24-hour format**: Choose what time backups should run
|
|
- **Recommendation**: Pick a low-traffic time (like 2:00 AM)
|
|
|
|
#### 📦 Backup Content
|
|
- **📁 WordPress files & uploads**: Include your site files
|
|
- **🗄️ Complete database**: Include your site database
|
|
- **Recommendation**: Keep both checked for complete backups
|
|
|
|
#### 🗂️ Backup Retention
|
|
- **Options**: Keep 5, 10, 15, 30, or unlimited backups
|
|
- **Auto-cleanup**: Older backups automatically deleted when limit reached
|
|
- **Recommendation**: 10 backups provides good balance of safety and storage
|
|
|
|
### 💡 Quick Setup Guide
|
|
|
|
1. **✅ Check "Enable Automated Backups"**
|
|
2. **🕐 Choose frequency** (Daily recommended for active sites)
|
|
3. **⏰ Pick a time** (2:00 AM is usually good)
|
|
4. **📦 Select content** (both files and database recommended)
|
|
5. **🗂️ Set retention** (10 backups is usually perfect)
|
|
6. **🐾 Click "Save Schedule Settings"**
|
|
|
|
## ☁️ S3/MinIO Storage Configuration
|
|
|
|
Set up cloud storage for off-site backup safety.
|
|
|
|
### When to Use Cloud Storage
|
|
- **Extra Protection**: Backups stored away from your server
|
|
- **Disaster Recovery**: Safe even if your server fails
|
|
- **Compliance**: Some regulations require off-site backups
|
|
- **Peace of Mind**: Sleep better knowing backups are safe
|
|
|
|
### Configuration Fields
|
|
|
|
#### ☁️ Enable Cloud Storage
|
|
- **Checkbox**: Turn cloud storage on/off
|
|
- **When enabled**: All storage options become available
|
|
|
|
#### 🔗 S3 Endpoint
|
|
- **AWS S3**: Leave blank for standard Amazon S3
|
|
- **MinIO**: Enter your MinIO server URL (like `https://minio.example.com`)
|
|
- **Other S3-compatible**: Enter provider's endpoint URL
|
|
|
|
#### 🪣 Bucket Name
|
|
- **What it is**: The "folder" where your backups will be stored
|
|
- **Requirements**: Must be unique, lowercase, no spaces
|
|
- **Examples**: `my-site-backups`, `company-wp-backups`
|
|
|
|
#### 🔑 Access Key ID & 🔐 Secret Access Key
|
|
- **What they are**: Credentials to access your cloud storage
|
|
- **Where to get them**: From your cloud provider's dashboard
|
|
- **Security**: Keep these secret and secure
|
|
|
|
#### 🌍 S3 Region
|
|
- **What it is**: Geographic location of your storage
|
|
- **Common examples**: `us-east-1`, `eu-west-1`, `ap-southeast-1`
|
|
- **Where to find**: In your cloud provider's settings
|
|
|
|
### 🛡️ Security Best Practices
|
|
|
|
1. **🔐 Use Strong Credentials**: Generate secure access keys
|
|
2. **🏠 Separate Buckets**: Don't mix backup buckets with other data
|
|
3. **🔒 Encrypt Storage**: Enable encryption in your cloud provider
|
|
4. **📝 Document Setup**: Keep configuration details in a secure password manager
|
|
|
|
## 🚨 Common Questions
|
|
|
|
### ❓ "I don't see my Territory Status at the top!"
|
|
- **Solution**: Refresh the page, clear browser cache
|
|
- **Check**: Make sure you're on the Territory Settings page
|
|
- **Plugin**: Ensure TigerStyle Life9 Complete plugin is activated
|
|
|
|
### ❓ "My automated backups aren't running!"
|
|
- **Check Territory Status**: WordPress Cron should show ✅ Active
|
|
- **Verify Settings**: Ensure "Enable Automated Backups" is checked
|
|
- **Time Zone**: Backups run in server time, not your local time
|
|
- **Traffic**: Site needs some traffic for WordPress cron to trigger
|
|
|
|
### ❓ "Cloud storage settings aren't saving!"
|
|
- **Credentials**: Double-check access key and secret key
|
|
- **Bucket**: Ensure bucket name follows naming rules
|
|
- **Permissions**: Access keys need read/write permission to bucket
|
|
- **Endpoint**: Verify endpoint URL is correct for your provider
|
|
|
|
### ❓ "Where do I find my cloud storage credentials?"
|
|
- **AWS S3**: IAM Users section in AWS Console
|
|
- **MinIO**: Admin panel → Identity → Users
|
|
- **Other providers**: Check your provider's documentation
|
|
|
|
## 🎯 Quick Start Checklist
|
|
|
|
### For Local Backups Only
|
|
- [ ] ✅ Enable Automated Backups
|
|
- [ ] 🕐 Set frequency (Daily recommended)
|
|
- [ ] ⏰ Choose time (2:00 AM suggested)
|
|
- [ ] 📦 Include files and database
|
|
- [ ] 🗂️ Set retention (10 backups)
|
|
- [ ] 🐾 Save settings
|
|
|
|
### For Cloud Backups
|
|
- [ ] Complete local backup setup above
|
|
- [ ] ☁️ Enable Cloud Storage
|
|
- [ ] 🔗 Enter S3 endpoint (if not AWS)
|
|
- [ ] 🪣 Create and enter bucket name
|
|
- [ ] 🔑 Add access credentials
|
|
- [ ] 🌍 Set correct region
|
|
- [ ] ☁️ Save storage settings
|
|
|
|
## 🆘 Need Help?
|
|
|
|
If something's not working:
|
|
|
|
1. **📊 Check Territory Status**: Red ❌ indicators show what needs attention
|
|
2. **🔄 Try Again**: Sometimes refreshing helps
|
|
3. **🧹 Clear Cache**: Browser cache can cause display issues
|
|
4. **📱 Different Browser**: Test in incognito mode
|
|
5. **📝 Check Logs**: WordPress admin may show error messages
|
|
|
|
---
|
|
|
|
**🐱 TigerStyle Life9 Complete - Territory Settings Made Simple!**
|
|
|
|
*Navigate your backup territory with the confidence of a cat who knows exactly where all the best napping spots are! 😸*
|
|
|
|
### Remember
|
|
- **📊 Territory Status**: Your new best friend at the top of the page
|
|
- **🔄 Automated Backups**: Set it and forget it (like a cat nap)
|
|
- **☁️ Cloud Storage**: Extra protection for extra peace of mind
|
|
- **🐾 Save Settings**: Don't forget to save your configuration!
|
|
|
|
*Happy backing up! Your future self (and your nine lives) will thank you! 🐾* |