First Day Checklist¶
New to the CharlieHub cluster? Complete these tasks to get oriented.
Prerequisites¶
- [ ] SSH access to at least one Proxmox node (px1, px2, px3, or px5)
- [ ] Understanding of basic Linux commands
- [ ] Familiarity with Proxmox concepts (VMs, CTs, storage)
Day 1 Tasks¶
1. Verify Cluster Access¶
# SSH to px1 (primary node)
ssh root@REDACTED_IP
# Check cluster status
pvecm status
# List all VMs/CTs
infra list
2. Understand the Infrastructure CLI¶
# List all infrastructure assets
infra list
# Decode a VMID
infra decode 1111
# Check for conflicts
infra conflicts
3. Access Key Services¶
| Service | URL | Purpose |
|---|---|---|
| Homarr | https://homarr.charliehub.net | Dashboard home |
| Grafana | https://grafana.charliehub.net | Monitoring dashboards |
| Prometheus | https://prometheus.charliehub.net | Metrics queries |
| Domain Manager | https://charliehub.net | Domain/routing management |
4. Set Up Your SSH Access¶
If you need to access VMs/CTs from external machines:
- Get your SSH public key added to the cluster
- Configure ProxyJump in your SSH config
5. Familiarize with Backup Status¶
# Check recent snapshots
zfs list -t snapshot | grep daily | tail -10
# Verify backup storage
df -h /mnt/backup-storage
6. Review Monitoring¶
- Open Grafana: https://grafana.charliehub.net
- Check the UniFi dashboards for network health
- Review Prometheus alerts: https://prometheus.charliehub.net/alerts
Key Contacts & Resources¶
| Resource | Location |
|---|---|
| Documentation | https://docs.charliehub.net |
| Homarr Dashboard | https://homarr.charliehub.net |
Common First-Day Issues¶
"Permission denied" when SSH-ing¶
- Check your key is deployed:
setup-vm-ssh <vmid> - Verify SSHPiper is running on VM1111
Cannot access web services¶
- Check Traefik is running on VM1111
- Verify DNS resolution for *.charliehub.net