Operations

IP Testing

Run the full Binexia stack using IP addresses — no DNS setup needed.

IP testing runs the full stack on any machine accessible via LAN. No dnsmasq, no Traefik, no domains.

When to Use

  • IP testing: Quick setup, testing from another machine on the network, demos
  • Local dev (dnsmasq): Daily development, hot reload, multiple services with named URLs

Setup

1. Clone and configure

git clone https://github.com/krecco/ubios.git
cd ubios
cp .env.testip .env.testip.local

# Edit .env.testip.local — add GITHUB_TOKEN (required) and LLM keys (optional)
nano .env.testip.local

2. Find your IP

hostname -I | awk '{print $1}'
# Example: 192.168.1.50

3. Start

export HOST_IP=192.168.1.50

docker compose \
  -f docker-compose.ip-test.yml \
  --env-file .env.testip.local \
  up -d --build

First build: 5–10 minutes. Subsequent starts: ~30 seconds.

4. Initialize database

# Create databases for Dify and Metabase
docker exec -it ubios_api bash -c '
  PGPASSWORD=331331331 psql -U postgres -h ubios_postgres -c "CREATE DATABASE ubios_dify;" 2>/dev/null
  PGPASSWORD=331331331 psql -U postgres -h ubios_postgres -c "CREATE DATABASE ubios_metabase;" 2>/dev/null
  echo "Databases ready"
'

# Generate app key
docker exec -it ubios_api php artisan key:generate --force

# Run migrations
docker exec -it ubios_api php artisan migrate

# Seed demo data
docker exec -it ubios_api php artisan db:seed --class=UbiosDatabaseSeeder

5. Access

From any machine on the same network:

http://192.168.1.50:6080

Login: admin@ubios.local / password

Service Access URLs

ServiceURLPurpose
Frontendhttp://{IP}:6080Main app
API (direct)http://{IP}:6081Laravel API debugging
Agno healthhttp://{IP}:8001/healthAgent runtime status
MinIO consolehttp://{IP}:9001Document storage
Metabasehttp://{IP}:3000BI dashboards
Mailpithttp://{IP}:8025Email testing
Dify UIhttp://{IP}:3080Knowledge pipeline
LiteLLM Proxyhttp://{IP}:4000/healthLLM gateway status
Uptime Kumahttp://{IP}:3001Service monitoring dashboard
Dozzlehttp://{IP}:8080Real-time log viewer

Adding LLM Keys Later

Edit .env.testip.local and restart — no rebuild needed:

nano .env.testip.local
# Add: OPENAI_API_KEY=sk-...

docker compose -f docker-compose.ip-test.yml --env-file .env.testip.local up -d