Skip to content

Getting Started

Overview

This guide provides a quick start for working with Smart Smoker V2 infrastructure. For detailed information, see the feature-specific documentation.

Prerequisites

  • Access to Proxmox server
  • SSH access to containers
  • GitHub repository access
  • Basic knowledge of Docker, Terraform, and Ansible

Quick Start

1. Infrastructure Setup

Terraform (provision infrastructure): 

cd infra/proxmox/terraform
cp terraform.tfvars.example terraform.tfvars
# Edit terraform.tfvars with your configuration
terraform init
terraform plan
terraform apply

Ansible (configure infrastructure): 

cd infra/proxmox/ansible
ansible-playbook playbooks/site.yml

2. Deploy Application

Development: 

cd /opt/smart-smoker-dev
git pull origin master
docker compose -f cloud.docker-compose.yml up -d

Production: 

cd /opt/smart-smoker-prod
git pull origin <tag>
./scripts/deployment-backup.sh
docker compose -f cloud.docker-compose.yml up -d
./scripts/deployment-health-check.sh localhost 3

3. Verify Deployment

# Check container health
docker ps --filter health=healthy

# Test health endpoints
curl http://localhost:8443/api/health | jq

# Check logs
docker compose -f cloud.docker-compose.yml logs --tail=50

Common Tasks

View Container Status

# All containers
docker ps -a

# Healthy containers
docker ps --filter health=healthy

# Container logs
docker logs <container-name> --tail 50

Backup Operations

# Create backup
/opt/smart-smoker-prod/scripts/backup-mongodb.sh

# Verify backup
/opt/smart-smoker-prod/scripts/backup-validation.sh

# Restore from backup
# See Backups documentation

Troubleshooting

# Check service health
./scripts/deployment-health-check.sh localhost 3

# View logs
docker compose -f cloud.docker-compose.yml logs -f

# Restart services
docker compose -f cloud.docker-compose.yml restart

Next Steps

Last Updated: 2025-12-07