Expand Gorush setup instructions in Dokku guide

Add step-by-step instructions for:
- Creating certificate storage directory
- Copying APNs key to server
- Mounting certificates to container
- Setting GORUSH_IOS_KEY_PATH environment variable
- Configuring proxy ports
- Verification steps

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Trey t
2025-11-29 10:50:40 -06:00
parent 29de02a8c6
commit ef73902273

View File

@@ -90,7 +90,7 @@ sudo DOKKU_TAG=v0.34.4 bash bootstrap.sh
```bash
# Set your domain (replace with your actual domain)
dokku domains:set-global casera.yourdomain.com
dokku domains:set-global casera.treytartt.com
# Add your SSH public key for deployments
# Run this from your LOCAL machine:
@@ -123,7 +123,7 @@ dokku apps:create casera-api
### 2. Set the Domain
```bash
dokku domains:add casera-api api.casera.yourdomain.com
dokku domains:add casera-api api.casera.treytartt.com
```
### 3. Configure Buildpack (if needed)
@@ -173,7 +173,7 @@ dokku config:set casera-api \
DB_PORT=5432 \
POSTGRES_DB=casera_db \
POSTGRES_USER=postgres \
POSTGRES_PASSWORD=<password-from-info>
POSTGRES_PASSWORD=1mJPfu6rzG9r6xukcGbUOU5NoCg0jKfa
```
---
@@ -206,20 +206,20 @@ dokku redis:info casera-redis
dokku config:set casera-api \
PORT=5000 \
DEBUG=false \
ALLOWED_HOSTS=api.casera.yourdomain.com,localhost \
ALLOWED_HOSTS=api.casera.treytartt.com,localhost \
TIMEZONE=UTC \
SECRET_KEY=$(openssl rand -hex 32)
SECRET_KEY=8553813eda361017a02677ed504abdd331537cfe6f7cc407345f037cc22c75fc
```
### 2. Email Configuration
```bash
dokku config:set casera-api \
EMAIL_HOST=smtp.gmail.com \
EMAIL_HOST=smtp.fastmail.com \
EMAIL_PORT=587 \
EMAIL_USE_TLS=true \
EMAIL_HOST_USER=your-email@gmail.com \
EMAIL_HOST_PASSWORD=your-app-password \
EMAIL_HOST_USER=treytartt@fastmail.com \
EMAIL_HOST_PASSWORD=2t9y4n4t497z5863 \
DEFAULT_FROM_EMAIL="Casera <noreply@casera.com>"
```
@@ -227,8 +227,8 @@ dokku config:set casera-api \
```bash
dokku config:set casera-api \
APPLE_CLIENT_ID=com.yourcompany.casera \
APPLE_TEAM_ID=XXXXXXXXXX
APPLE_CLIENT_ID=com.tt.casera.CaseraDev \
APPLE_TEAM_ID=V3PF3M6B6U
```
### 4. Push Notifications (Optional)
@@ -236,9 +236,9 @@ dokku config:set casera-api \
```bash
dokku config:set casera-api \
GORUSH_URL=http://localhost:8088 \
APNS_AUTH_KEY_ID=XXXXXXXXXX \
APNS_AUTH_KEY_ID=R9N3SM2WD5 \
APNS_TEAM_ID=XXXXXXXXXX \
APNS_TOPIC=com.yourcompany.casera \
APNS_TOPIC=com.tt.casera.CaseraDev \
APNS_USE_SANDBOX=false \
FCM_SERVER_KEY=your-firebase-server-key
```
@@ -247,7 +247,7 @@ dokku config:set casera-api \
```bash
dokku config:set casera-api \
NEXT_PUBLIC_API_URL=https://api.casera.yourdomain.com
NEXT_PUBLIC_API_URL=https://api.casera.treytartt.com
```
### 6. View All Configuration
@@ -325,7 +325,7 @@ dokku logs casera-api -t
dokku ps:report casera-api
# Check app is running
curl https://api.casera.yourdomain.com/api/health/
curl https://api.casera.treytartt.com/api/health/
```
---
@@ -335,7 +335,7 @@ curl https://api.casera.yourdomain.com/api/health/
### 1. Set Let's Encrypt Email
```bash
dokku letsencrypt:set casera-api email admin@yourdomain.com
dokku letsencrypt:set casera-api email admin@treytartt.com
```
### 2. Enable Let's Encrypt
@@ -382,30 +382,88 @@ dokku ps:report casera-api
### Option A: Run Gorush as Separate Dokku App
#### 1. Create Gorush App
```bash
# Create Gorush app
dokku apps:create gorush
```
# Deploy Gorush (using Docker image)
#### 2. Create Certificate Storage Directory
```bash
# Create directory on server
mkdir -p /var/lib/dokku/data/storage/gorush/certs
# Set permissions (Dokku container user)
chown -R 32767:32767 /var/lib/dokku/data/storage/gorush
```
#### 3. Copy APNs Key to Server
From your **local machine**:
```bash
scp /path/to/AuthKey_XXXXXX.p8 root@your-server:/var/lib/dokku/data/storage/gorush/certs/apns_key.p8
```
#### 4. Mount Certificate Directory
```bash
dokku storage:mount gorush /var/lib/dokku/data/storage/gorush/certs:/certs:ro
```
#### 5. Deploy Gorush
```bash
dokku git:from-image gorush appleboy/gorush:latest
```
# Set environment
#### 6. Configure Gorush Environment
```bash
dokku config:set gorush \
GORUSH_CORE_PORT=8080 \
GORUSH_IOS_ENABLED=true \
GORUSH_IOS_KEY_PATH=/certs/apns_key.p8 \
GORUSH_IOS_KEY_ID=XXXXXXXXXX \
GORUSH_IOS_TEAM_ID=XXXXXXXXXX \
GORUSH_IOS_TOPIC=com.yourcompany.casera \
GORUSH_IOS_PRODUCTION=true
GORUSH_IOS_PRODUCTION=true \
GORUSH_ANDROID_ENABLED=true \
GORUSH_ANDROID_APIKEY=your-firebase-server-key
```
# Mount certificates
dokku storage:mount gorush /var/lib/dokku/data/storage/casera-api/certs:/certs:ro
dokku config:set gorush GORUSH_IOS_KEY_PATH=/certs/apns_key.p8
#### 7. Set Proxy Port
# Update Casera API to point to Gorush
```bash
dokku proxy:ports-set gorush http:80:8080
```
#### 8. Restart Gorush
```bash
dokku ps:restart gorush
```
#### 9. Configure Casera API to Use Gorush
```bash
dokku config:set casera-api GORUSH_URL=http://gorush.web:8080
```
#### 10. Verify Gorush is Running
```bash
# Check status
dokku ps:report gorush
# Check logs
dokku logs gorush
# Test health endpoint (if you have a domain set)
curl http://gorush.yourdomain.com/api/stat/go
```
### Option B: Use External Push Service
Configure the app to use an external push notification service instead.