# Temp-Number App Quick Start

> Deployment comparison and starting point for the setup wizard, local Docker, Google Cloud, and manual Temp-Number deployment paths.


## Deployment Options

The Temp-Number App supports multiple deployment strategies to fit different use cases.

### Comparison Table

| Feature         | Local Docker     | Google Cloud  | Manual Setup |
| --------------- | ---------------- | ------------- | ------------ |
| **Setup Time**  | 5-10 minutes     | 25-40 minutes | 1-2 hours    |
| **Cost**        | Free             | $20-100/month | Varies       |
| **Scalability** | -                | Auto-scaling  | Manual       |
| **SSL/HTTPS**   | -                | Automatic     | Manual       |
| **Database**    | Docker container | Cloud SQL     | Self-managed |
| **Best For**    | Development      | Production    | Custom needs |
| **Maintenance** | -                | Managed       | Full control |

## Deployment Paths

### 1. ⚡ Setup Wizard (Recommended)

**Best for**: All users, especially first-time deployments

The interactive setup wizard guides you through the entire deployment process:

- Validates prerequisites
- Collects configuration interactively
- Configures Firebase and cloud resources
- Deploys to your chosen platform (Local Docker or Google Cloud)
- Provides post-deployment instructions

**Command**:

```bash
git clone https://github.com/platfone-com/temp-number-deploy.git
cd temp-number-deploy
./setup-wizard.sh
```


> **Minimal Vars to Launch**


For the demo build (limited features) just set `PLATFONE_API_KEY` in the `backend.secrets` file.




**Learn more**: [Setup Wizard Guide →](/docs/temp-number/deployment/setup-wizard/)

- [Setup Wizard](https://platfone.com/docs/temp-number/deployment/setup-wizard.md): Interactive setup wizard that handles all prerequisites and configuration


---

### 2. Local Docker Compose

**Best for**: Development, testing, and evaluation

Run the complete stack on your local machine using Docker Compose:

- ✅ Quick setup (5-10 minutes)
- ✅ No cloud costs
- ✅ Full development environment
- ⚠️ Not suitable for production
- ⚠️ Limited to local access

**Use cases**:

- Testing the platform before production deployment
- Local development and customization
- Training and demonstrations

**Learn more**: [Local Docker Guide →](/docs/temp-number/deployment/local-docker-deployment/)

**Watch the video tutorial:**

<div style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden;">
      <iframe allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share; fullscreen" loading="eager" referrerpolicy="strict-origin-when-cross-origin" src="https://www.youtube.com/embed/SXoU-PhTg5U?autoplay=0&amp;controls=1&amp;end=0&amp;loop=0&amp;mute=0&amp;start=0" style="position: absolute; top: 0; left: 0; width: 100%; height: 100%; border:0;" title="YouTube video"></iframe>
    </div>


---

### 3. Google Cloud Platform

**Best for**: Production deployments with automatic scaling

Deploy to Google Cloud Run with Cloud SQL for a fully managed, production-ready setup:

- ✅ Automatic HTTPS with managed certificates
- ✅ Auto-scaling based on traffic
- ✅ Managed database backups
- ✅ Global CDN and load balancing
- ⚙️ Seamless CI/CD and monitoring integration
- 💰 Pay-as-you-go pricing (~$20-100/month)

**Architecture**:

- **Backend**: Cloud Run container
- **Database**: Cloud SQL (MySQL)
- **Frontend**: Cloud Run container with Nginx
- **SSL**: Google-managed certificates
- **DNS**: Cloud DNS or external provider

**Learn more**: [Google Cloud Guide →](/docs/temp-number/deployment/google-cloud-deployment/)

**Watch the video tutorial:**

<div style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden;">
      <iframe allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share; fullscreen" loading="eager" referrerpolicy="strict-origin-when-cross-origin" src="https://www.youtube.com/embed/06QCZZRReas?autoplay=0&amp;controls=1&amp;end=0&amp;loop=0&amp;mute=0&amp;start=0" style="position: absolute; top: 0; left: 0; width: 100%; height: 100%; border:0;" title="YouTube video"></iframe>
    </div>


---

### 4. Manual Setup

**Best for**: Custom infrastructure or specific requirements

Deploy to your own infrastructure with full control:

- ✅ Complete flexibility
- ✅ Use any cloud provider or on-premises
- ✅ Custom security configurations
- ⚠️ Requires DevOps expertise
- ⚠️ Manual scaling and maintenance

**Supported platforms**:

- AWS (EC2, RDS, ECS)
- Azure (Container Instances, Azure SQL)
- DigitalOcean (Droplets, Managed Databases)
- Self-hosted servers

## Decision Tree



**Choose based on your needs**:

1. **I want to evaluate the platform** → Start with Local Docker
2. **I need production deployment ASAP** → Use Google Cloud with Setup Wizard
3. **I have specific infrastructure requirements** → Go with Manual Setup
4. **I'm not sure what I need** → Start with Setup Wizard



We highly recommend starting with the Setup Wizard
to simplify the process and ensure all prerequisites are met.



## What's Included in All Deployments

Regardless of your chosen method, you'll get:

- 🔧 **Backend API**: Complete AdonisJS backend with all features
- 🖥️ **Web Application**: Full Vue.js frontend
- 🗄️ **Database**: MySQL/MariaDB with initial schema
- 🔐 **Authentication**: Firebase Auth integration
- 💳 **Payment Processing**: Stripe and other gateways
- 📚 **API Documentation**: OpenAPI/Swagger UI
- 🔒 **Security**: CORS, rate limiting, input validation

## Prerequisites by Deployment Type

### All Deployments Need

- Platfone API credentials
- Firebase project (Auth + optional FCM)
- Payment gateway account (Stripe recommended)

### Local Docker Needs

- Docker & Docker Compose installed
- 4GB+ RAM available
- Ports 8080, 3333, 3336 available

### Google Cloud Needs

- Google Cloud account with billing enabled
- `gcloud` CLI installed and authenticated
- Domain name (optional but recommended)

### Manual Setup Needs

- Server with Node.js 22.x+
- MySQL 8.0+ database
- Nginx or similar reverse proxy
- SSL certificates (Let's Encrypt recommended)

## Cost Estimates

### Local Docker

- **Cost**: Free (uses local resources)
- **Requirements**: Development machine with Docker

### Google Cloud (Production)

Estimated monthly costs for moderate traffic:

| Component               | Cost Range       |
| ----------------------- | ---------------- |
| Cloud Run (Backend)     | $10-30/month     |
| Cloud Run (Frontend)    | $5-15/month      |
| Cloud SQL (db-f1-micro) | $7-15/month      |
| Networking/Egress       | $5-20/month      |
| **Total**               | **$27-80/month** |

*Costs scale with traffic. Free tier covers ~2M requests/month.*

### Manual Setup

- **Infrastructure**: $5-100/month (provider dependent)
- **Maintenance**: Your DevOps time
- **Backups**: Additional costs may apply

## Next Steps

Ready to deploy? Choose your path:


  - [Setup Wizard](https://platfone.com/docs/temp-number/deployment/setup-wizard.md): Guided interactive deployment

  - [Local Docker](https://platfone.com/docs/temp-number/deployment/local-docker-deployment.md): Development environment

  - [Google Cloud](https://platfone.com/docs/temp-number/deployment/google-cloud-deployment.md): Production deployment