Skip to content

Development VPS Services

Complete documentation of all services running on Development VPS (46.224.125.1).

Quick Reference Table

Service URL Port Purpose Backup Type Recovery Priority
open-webui dev.kua.cl 3000 AI chat interface Data directory LOW

Service Details

open-webui - AI Chat Interface

Purpose: Web UI for interacting with AI models (compatible with OpenAI API, Ollama, etc.)

Container: open-webui

Access: - URL: https://dev.kua.cl - Port: 3000 - Location: /opt/open-webui

Data Location: - Data directory: /opt/open-webui/data (chat history, user settings, uploaded files) - Configuration: /opt/open-webui/.env, /opt/open-webui/docker-compose.yml

Features: - Chat with AI models (OpenAI, Claude, Ollama) - Document upload and analysis - Code generation and debugging - Multi-model switching - Chat history preservation

Backup Strategy: - Data directory: Weekly backup to Storage Box - Configuration: .env file backup - Chat history: Included in data directory backup - Fresh install: OK (chat history not critical)

Recovery Time: 5 minutes

Recovery Process: 

# Option 1: Restore data directory
rsync -avz /mnt/storagebox/backups/weekly/open-webui/ /opt/open-webui/data/

# Option 2: Fresh install (acceptable for dev environment)
cd /opt/open-webui && docker-compose up -d

# Restore configuration
cp /mnt/storagebox/backups/configs/open-webui/.env /opt/open-webui/

Notes: - Chat history not critical (development environment) - API keys stored in Infisical (secrets.kua.cl) - Can connect to multiple AI providers - Runs on Development VPS to isolate load from production services

Docker Compose Configuration

open-webui

version: '3.8'

services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    container_name: open-webui
    restart: unless-stopped
    ports:
      - "3000:8080"
    volumes:
      - ./data:/app/backend/data
    environment:
      - OPENAI_API_KEY=${OPENAI_API_KEY}
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
    networks:
      - open-webui-network

networks:
  open-webui-network:
    driver: bridge

Environment Variables

Located in /opt/open-webui/.env:

# AI Provider API Keys (stored in Infisical)
OPENAI_API_KEY=<stored in Infisical>
ANTHROPIC_API_KEY=<stored in Infisical>

# Application Configuration
PORT=3000
NODE_ENV=development

Security Note: API keys are stored in Infisical (secrets.kua.cl)

Maintenance Commands

View Logs

ssh dev "docker logs -f open-webui"

Restart Service

ssh dev "cd /opt/open-webui && docker-compose restart"

Update to Latest Version

ssh dev "cd /opt/open-webui && docker-compose pull && docker-compose up -d"

Check Data Directory Size

ssh dev "du -sh /opt/open-webui/data"

Usage Examples

Access Web Interface

  1. Navigate to https://dev.kua.cl
  2. Sign in (or create account on first visit)
  3. Select AI model from dropdown
  4. Start chatting

Upload Documents for Analysis

  1. Click upload button in chat interface
  2. Select document (PDF, TXT, MD, etc.)
  3. Ask questions about the document
  4. open-webui processes and analyzes content

Switch Between AI Models

  1. Click model dropdown in chat interface
  2. Select model (GPT-4, Claude, Llama, etc.)
  3. Continue conversation with new model

Future Services (Planned)

The Development VPS can host additional development tools:

  • Staging environment: Test new services before production deployment
  • Database playground: PostgreSQL/MySQL for testing
  • Code server: VS Code in browser
  • Jupyter notebooks: Data science experimentation
  • Local Ollama: Self-hosted LLM models

Resource Monitoring

Check CPU/Memory Usage

ssh dev "docker stats"

Check Disk Usage

ssh dev "df -h"

View System Load

ssh dev "uptime"

Cost Optimization

Current Cost: €9.49/month (CX32)

Optimization Options:

  1. Scale down when not in use: CX22 (€5.83/mo) for light workloads
  2. Pause VPS: Snapshot VPS, delete instance, restore when needed (€0.05/GB/mo for snapshot)
  3. Shared VPS: Run dev services on Production VPS (not recommended - load isolation)

Recommendation: Keep CX32 for consistent development environment

Troubleshooting

Issue: open-webui not responding

Solution: 

# 1. Check if container is running
ssh dev "docker ps | grep open-webui"

# 2. Check logs for errors
ssh dev "docker logs open-webui"

# 3. Restart container
ssh dev "cd /opt/open-webui && docker-compose restart"

Issue: API keys not working

Solution: 1. Check Infisical for current API keys 2. Update /opt/open-webui/.env with correct keys 3. Restart open-webui: docker-compose restart

Issue: Out of disk space

Solution: 

# 1. Check disk usage
ssh dev "df -h"

# 2. Clean up old Docker images
ssh dev "docker system prune -a"

# 3. Clear open-webui data (if acceptable)
ssh dev "rm -rf /opt/open-webui/data/uploads/*"