dreamhost manager
- Repo stars 0
- Author repo nano-core
- Domain
- Other
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @0-CYBERDYNE-SYSTEMS-0 · no license declared
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- Python
- Detected file/system behavior
-
- Read-only
- Write / modify
- Shell exec
- Env read
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# DreamHost Manager Skill
## When to use this skill
- Use when the user request matches this skill's domain and capabilities.
- Use when this workflow or toolchain is explicitly requested.
## When not to use this skill
- Do not use when another skill is a better direct match for the task.
- Do not use when the request is outside this skill's scope.
Complete solution for managing websites on DreamHost hosting via SFTP/SSH.
## Quick Start
### 1. Setup Credentials
Copy and configure `.env` file:
```bash
cp assets/.env.template .env
# Edit .env with your DreamHost credentials
```
See `setup_guide.md` for detailed credential setup.
### 2. Configure Domain Mappings (Optional but Recommended)
Add your domains to `.env` for convenient naming:
```bash
# .env
DOMAIN_farm-friend.com=/home/dh_cqevup/farm-friend.com
DOMAIN_yourdomain.com=/home/username/yourdomain.com
```
### 3. Test Connection
Verify your setup works (using domain name or full path):
```bash
# Using domain name (if configured in .env)
python scripts/sftp_operations.py list farm-friend.com
# Using full path (always works)
python scripts/sftp_operations.py list /home/dh_cqevup/farm-friend.com
```
### 4. Deploy Your Site
**For React apps:**
```bash
# Using domain name
python scripts/react_deployer.py deploy . farm-friend.com
python scripts/routing_manager.py configure-app farm-friend.com
# Or using full path
python scripts/react_deployer.py deploy . /home/dh_cqevup/farm-friend.com
python scripts/routing_manager.py configure-app /home/dh_cqevup/farm-friend.com
```
**For static sites:**
```bash
python scripts/directory_sync.py upload ./my-website farm-friend.com
```
**For backups:**
```bash
python scripts/backup_restore.py backup farm-friend.com ./backups
```
## Core Features
### React Application Deployment
Deploy React apps built with Create React App, Vite, or Next.js:
```bash
python scripts/react_deployer.py deploy <project_dir> <remote_path>
```
Automatically:
- Detects framework type
- Runs build process
- Uploads optimized artifacts
- Cleans old deployments
### Multi-Site Routing
Configure multiple sites on same domain using:
- **Subdomains**: `app1.yourdomain.com`, `app2.yourdomain.com`
- **Subdirectories**: `yourdomain.com/app1`, `yourdomain.com/app2`
```bash
# Subdomain
python scripts/routing_manager.py configure-subdomain /home/user/app1.yourdomain.com
# Subdirectory
python scripts/routing_manager.py configure-subdir app1 /home/user/yourdomain.com/app1
```
### File Operations
Upload, download, and manage files:
```bash
# Upload single file
python scripts/sftp_operations.py upload ./index.html yourdomain.com/index.html
# Download file
python scripts/sftp_operations.py download yourdomain.com/index.html ./backup.html
# List files
python scripts/sftp_operations.py list yourdomain.com
# Create directory
python scripts/sftp_operations.py mkdir yourdomain.com/new-folder
# Delete file
python scripts/sftp_operations.py delete yourdomain.com/old.html
```
Note: Use domain names (if configured in .env) or full paths like `/home/user/yourdomain.com`
### Directory Synchronization
Sync entire directories for quick deployments:
```bash
python scripts/directory_sync.py upload ./my-website yourdomain.com
```
Features:
- Recursive upload/download
- Timestamp comparison (skips unchanged files)
- Automatic exclusion (.git, node_modules, etc.)
- Progress tracking
### Backup & Restore
Create and restore timestamped backups:
```bash
# Create backup
python scripts/backup_restore.py backup yourdomain.com ./backups
# List backups
python scripts/backup_restore.py list ./backups
# Restore backup
python scripts/backup_restore.py restore ./backups/backup_20240115_120000.tar.gz yourdomain.com
```
Features:
- Automatic timestamped backups
- Tar.gz compression
- Safe restore (backs up current version first)
- Large file support
### Blog & Content Management
Upload and manage blog posts:
```bash
# Upload post with images
python scripts/blog_manager.py upload ./posts/my-post.md yourdomain.com/blog
# List posts
python scripts/blog_manager.py list yourdomain.com/blog
# Update post
python scripts/blog_manager.py update ./posts/my-post.md yourdomain.com/blog/my-post.md
# Delete post
python scripts/blog_manager.py delete yourdomain.com/blog/old.md
```
### Server Commands
Execute shell commands on the server:
```bash
# Check disk usage
python scripts/ssh_commands.py disk-usage yourdomain.com
# Change file permissions
python scripts/ssh_commands.py chmod yourdomain.com/config.php 644
# Recursively change permissions (standard web setup)
python scripts/ssh_commands.py chmod-recursive yourdomain.com 644 755
# Create symlink
python scripts/ssh_commands.py symlink yourdomain.com /backup
# Find files
python scripts/ssh_commands.py find yourdomain.com "*.html"
# Execute custom command
python scripts/ssh_commands.py exec "cd /home/user/yourdomain.com && ls -la"
```
## Scripts Reference
| Script | Purpose | Key Functions |
|--------|---------|---------------|
| `sftp_operations.py` | Core file operations | upload, download, list, mkdir, delete, rename |
| `directory_sync.py` | Sync directories | Recursive upload/download with timestamp checking |
| `react_deployer.py` | Deploy React apps | Auto-detect framework, build, deploy artifacts |
| `routing_manager.py` | Configure routing | .htaccess for React Router, multi-site setup |
| `backup_restore.py` | Backup management | Create, restore, list timestamped backups |
| `ssh_commands.py` | Server commands | chmod, symlinks, find, disk usage |
| `blog_manager.py` | Blog content | Upload posts, manage assets, organize content |
## Documentation
- **setup_guide.md** - Credential setup and first-time configuration
- **common_workflows.md** - Practical examples for deployment, backups, content management
- **react_deployment.md** - React-specific deployment and multi-site routing
## Configuration
### .env File Format
```bash
DREAMHOST_HOST=your_host.dreamhost.com
DREAMHOST_USER=your_username
DREAMHOST_PASSWORD=your_password
# OR for SSH key (more secure):
# DREAMHOST_SSH_KEY_PATH=/path/to/.ssh/id_rsa
```
See `assets/.env.template` for complete template with security notes.
### Domain Name Mapping & Per-Domain Credentials
Each domain can have its own DreamHost credentials (host, user, password). Configure them in your `.env` file:
```bash
# .env
# ========== DOMAIN 1: farm-friend.com ==========
DOMAIN_farm-friend.com=/home/dh_cqevup/farm-friend.com
DREAMHOST_HOST_farm-friend.com=server1.dreamhost.com
DREAMHOST_USER_farm-friend.com=user1
DREAMHOST_PASSWORD_farm-friend.com=password1
# ========== DOMAIN 2: yourdomain.com ==========
DOMAIN_yourdomain.com=/home/dh_xxxx/yourdomain.com
DREAMHOST_HOST_yourdomain.com=server2.dreamhost.com
DREAMHOST_USER_yourdomain.com=user2
DREAMHOST_PASSWORD_yourdomain.com=password2
```
The agent automatically extracts the domain from your command and uses the matching credentials:
```bash
# Agent automatically uses farm-friend.com credentials
python scripts/sftp_operations.py list farm-friend.com
# Agent automatically uses yourdomain.com credentials
python scripts/react_deployer.py deploy . yourdomain.com
# Also works with full paths (uses credentials from the domain in the path)
python scripts/sftp_operations.py list /home/dh_cqevup/farm-friend.com
```
**How it works:**
1. Agent extracts domain from the command: `farm-friend.com`
2. Looks up credentials in .env: `DREAMHOST_HOST_farm-friend.com`, `DREAMHOST_USER_farm-friend.com`, etc.
3. Connects to that domain's DreamHost account
4. Performs the requested operation
This allows seamless management of multiple domains with different DreamHost accounts.
## Common Workflows
### Deploy Static Website
```bash
python scripts/directory_sync.py upload ./website yourdomain.com
```
### Deploy React App with Routing
```bash
python scripts/react_deployer.py deploy . yourdomain.com
python scripts/routing_manager.py configure-app yourdomain.com
```
### Daily Backup
```bash
python scripts/backup_restore.py backup yourdomain.com ./backups
```
### Update Blog Post
```bash
python scripts/blog_manager.py update ./posts/post.md yourdomain.com/blog/post.md
```
See `references/common_workflows.md` for more examples.
## Dependencies
Install required packages:
```bash
pip install -r requirements.txt
```
Required:
- **paramiko** - SFTP/SSH library
- **python-dotenv** - Environment variable loading
- **scp** - Enhanced file transfer
## Troubleshooting
### Connection Issues
1. Verify credentials in `.env`
2. Check host is accessible
3. Confirm SFTP port 22 is open
4. Test with: `python scripts/sftp_operations.py list /home/username`
See `references/setup_guide.md` for detailed troubleshooting.
## Next Steps
1. Follow setup in `references/setup_guide.md`
2. Test with examples in `references/common_workflows.md`
3. Deploy your site!
Sections and files
Listed in source order.
sections -> When to use this skill → When not to use this skill → Quick Start → 1. Setup Credentials → 2. Configure Domain Mappings (Optional but Recommended) → 3. Test Connection
terms -> For React apps · For static sites · For backups · Subdomains · Subdirectories · setupguide.md · commonworkflows.md · reactdeployment.md
files/cmd -> .env · setup_guide.md · app1.yourdomain.com · app2.yourdomain.com · yourdomain.com/app1 · yourdomain.com/app2 · /home/user/yourdomain.com · sftp_operations.py
body sha256 -> 39aa4fa89452
When to use this skill
Use when the user request matches this skill's domain and capabilities. Use when this workflow or toolchain is explicitly requested.
When not to use this skill
Do not use when another skill is a better direct match for the task. Do not use when the request is outside this skill's scope. Complete solution for managing websites on DreamHost hosting via SFTP/SSH.
1. Setup Credentials
Copy and configure
.envfile: Seesetup_guide.mdfor detailed credential setup.2. Configure Domain Mappings (Optional but Recommended)
Add your domains to
.envfor convenient naming:3. Test Connection
Verify your setup works (using domain name or full path):