Pulse/docs/CLOUD.md
2026-03-28 19:07:37 +00:00

121 lines
4.4 KiB
Markdown

# Pulse Cloud (Hosted)
Pulse Cloud is the hosted version of Pulse — a fully managed monitoring instance that runs in the cloud so you don't have to self-host.
## How It Works
1. **Sign up** at the Pulse Cloud portal.
2. **Connect your agents** — install the Pulse agent on your infrastructure pointing to your cloud URL.
3. **Monitor** — access your dashboard from any browser or supported Pulse Mobile client.
Each Cloud account gets a dedicated, isolated Pulse instance with its own subdomain (e.g., `yourname.cloud.pulserelay.pro`).
## Features
Pulse Cloud includes everything in the **Pro** plan, plus:
| Feature | Description |
|---|---|
| **Fully managed hosting** | No server to manage, no updates to apply |
| **Automatic updates** | Your instance is always on the latest version |
| **Automatic backups** | Daily encrypted backups with 7-day retention |
| **Dedicated instance** | Your data runs in an isolated container — not shared with other tenants |
| **Wildcard TLS** | HTTPS with auto-renewing certificates |
| **Mobile ready** | Relay is pre-configured for secure Pulse Mobile remote access |
### Cloud Enterprise (Add-On)
For organisations that need multi-tenant management:
| Feature | Capability Key |
|---|---|
| Multi-Tenant Mode | `multi_tenant` |
| Multi-User Mode | `multi_user` |
| Unlimited Instances | `unlimited` |
| White-Label Branding | `white_label` (coming soon) |
See [Plans & Entitlements](PULSE_PRO.md) for the full feature matrix.
## Getting Started
### 1. Create Your Account
Sign up via the Pulse Cloud portal. Your instance is provisioned automatically after checkout.
### 2. Connect Agents
Once your instance is running, install agents on your infrastructure:
```bash
curl -fsSL https://yourname.cloud.pulserelay.pro/install.sh | \
bash -s -- --url https://yourname.cloud.pulserelay.pro --token <api-token>
```
Generate installation commands from **Settings → Unified Agents → Installation commands** in your cloud dashboard.
### 3. Add Proxmox / TrueNAS Connections
Add your Proxmox VE, PBS, PMG, or TrueNAS systems via **Settings → Infrastructure** or **Settings → TrueNAS**.
### 4. Set Up Mobile Access
Relay is enabled by default on Cloud instances. Open **Settings → Relay** to prepare pairing and connect once mobile beta/public access is enabled.
## Data & Privacy
- Your monitoring data runs in an **isolated container** — no shared databases.
- Data is stored encrypted at rest.
- Backups are automated and encrypted.
- You can **export** your configuration at any time via **Settings → System → Recovery** and migrate to self-hosted if needed.
- See [Privacy](PRIVACY.md) for full details.
## Billing
Pulse Cloud billing is handled by Stripe. You can manage your subscription from the Cloud portal:
- View current plan and usage
- Update payment method
- Cancel or change plans
## Migrating To/From Cloud
### Self-Hosted → Cloud
1. **Export** from your self-hosted instance: **Settings → System → Recovery → Create Backup**.
2. **Import** into your Cloud instance: **Settings → System → Recovery → Restore Configuration**.
3. Update agent `--url` flags to point to your cloud URL.
### Cloud → Self-Hosted
1. **Export** from Cloud: **Settings → System → Recovery → Create Backup**.
2. Install Pulse on your own server (see [Install Guide](INSTALL.md)).
3. **Import** the backup.
4. Re-activate your license key (if switching to Pro self-hosted).
5. Update agent `--url` flags.
See [Migration Guide](MIGRATION.md) for detailed steps.
## FAQ
### Can I use my own domain?
Custom domain support is planned for a future release. Currently, instances use `*.cloud.pulserelay.pro` subdomains.
### Is my data shared with other users?
No. Each Cloud account runs in a dedicated, isolated container with its own data directory.
### What happens if I cancel?
Your data is retained for 30 days after cancellation. You can export your configuration at any time before deletion.
### Can I switch between Cloud and self-hosted?
Yes. Use the export/import workflow described above. Your monitoring configuration is fully portable.
## See Also
- [Plans & Entitlements](PULSE_PRO.md) — feature comparison across Community, Relay, Pro, Pro+, and Cloud
- [Installation (Self-Hosted)](INSTALL.md) — self-hosted installation guide
- [Relay / Mobile Access](RELAY.md) — relay setup and mobile rollout status (pre-configured on Cloud)
- [Multi-Tenant](MULTI_TENANT.md) — multi-tenant mode (Cloud Enterprise)