Skip to main content

Post-Installation

Complete the initial setup and verify that your ekai deployment is ready to use.

Accessing the Platform​

Local Deployment​

  • Frontend URL: http://localhost

Navigate to http://localhost in your browser to access ekai.

Cloud Deployment (GCP)​

  • Frontend URL: https://portal.yourcompany.com (your configured domain)
HTTPS

Cloud deployments automatically provision SSL certificates via Let's Encrypt. This may take 10-15 minutes after DNS configuration.

Initial Setup Wizard​

When you first access ekai, you'll be guided through a setup wizard:

Step 1: First Login​

Log in with the admin credentials you configured during installation.

Step 2: Complete Organization Setup​

  • Organization Name: Your company or team name
  • Timezone: Select your primary timezone
  • Locale: Choose language and regional settings

Step 3: Integration Settings (Optional)​

Configure initial integrations:

  • Data Warehouse: Connect your first warehouse
  • User Directory: LDAP/Active Directory sync (optional)
  • Notifications: Email and webhook settings

Step 4: Invite Team Members​

Navigate to Admin → Users to:

  • Invite team members via email
  • Assign roles and permissions
  • Set up user groups

Verification Checklist​

Ensure your deployment is working correctly:

Local Deployment​

  • All containers are running (docker ps shows 3 containers)
  • Frontend accessible at http://localhost
  • Can log in with admin credentials
  • Backend API responding at http://localhost:3000/health
  • Database connection healthy
  • No error messages in logs

Cloud Deployment (GCP)​

  • All pods are running (kubectl get pods -n ekai)
  • Frontend accessible via HTTPS
  • Can log in with admin credentials
  • Backend API responding (/health returns 200)
  • Database connection healthy
  • SSL certificate valid (no browser warnings)
  • DNS resolving correctly
  • Email notifications working (test with user invite)

Basic Operations​

Local Deployment Management​

View Logs​

# All services (live tail)
docker-compose logs -f

# A specific service
docker-compose logs -f ekai-<service-name>

# Example
docker-compose logs -f ekai-frontend

# Last 100 lines
docker-compose logs --tail=100

Update to Latest Version​

# Pull latest images
docker-compose pull

# Recreate containers with new images
docker-compose up -d

# Verify update
docker ps

Getting Help​

If you encounter issues:

  1. Check the Troubleshooting Guide
  2. Review application logs for error messages
  3. Consult the FAQ
  4. Contact support at support@ekai.ai with:
    • Deployment mode (local/cloud)
    • Operating system and version
    • Error messages and logs
    • Steps to reproduce the issue

Next Steps​