Installation Guide - Docker/Packages

​

Prerequisites

​

License Requirement

• A valid Tyk AI Studio license from Tyk Technologies. Contact support@tyk.io or your account manager to obtain your license.

​

For Docker Compose Installation

• Docker and Docker Compose installed on your system
• PostgreSQL database (recommended for production) - if not provided, SQLite will be used as fallback

​

For Package Installation

• Linux system with systemd
• PostgreSQL database (strongly recommended) - if not configured, SQLite will be used as fallback

​

Installation Methods

​

Method 1: Docker Compose Installation

1. Create a new directory for your project:
   mkdir tyk-ai-studio && cd tyk-ai-studio
   
2. Create a compose directory and add the following Docker Compose file:
   mkdir compose && cd compose
   
3. Create a compose.yaml file with the following content:
    version: "3"
    services:
      ai-studio:
        image: tykio/tyk-ai-studio:latest
        volumes:
          - ./confs/.env:/app/.env
        environment:
          - DATABASE_URL=postgres://postgres:postgres@postgres:5432/postgres
          - DATABASE_TYPE=postgres
        depends_on:
          postgres:
            condition: service_healthy
        ports:
          - 8080:8080  # Main application port
          - 9090:9090  # Gateway server port
   
      postgres:
        image: postgres:latest
        environment:
          - POSTGRES_USER=postgres
          - POSTGRES_PASSWORD=postgres
          - POSTGRES_DB=postgres
        healthcheck:
          test: ["CMD-SHELL", "pg_isready -U postgres"]
          interval: 5s
          timeout: 5s
          retries: 5
   
4. Create a configuration directory and environment file:
   mkdir -p confs
   touch confs/.env
   
5. Add your configuration to the .env file (example): For PostgreSQL (recommended):
    ALLOW_REGISTRATIONS=true
    ADMIN_EMAIL=you@tyk.io
    SITE_URL=http://localhost:8080
    FROM_EMAIL=noreply@tyk.io
    DATABASE_URL=postgres://postgres:postgres@postgres:5432/postgres
    DATABASE_TYPE=postgres
    TYK_AI_SECRET_KEY=a35b3f7b0fb4dd3a048ba4fc6e9fe0a8cb804d7884c62b6b2ea09c99612c4405
    FILTER_SIGNUP_DOMAINS=tyk.io
    TYK_AI_LICENSE=XXXX
    # Optional SMTP settings
    # SMTP_SERVER=smtp.sendgrid.net
    # SMTP_PORT=587
    # SMTP_USER=apikey
    # SMTP_PASS=
   
   For SQLite (development only):
    ALLOW_REGISTRATIONS=true
    ADMIN_EMAIL=you@tyk.io
    SITE_URL=http://localhost:8080
    FROM_EMAIL=noreply@tyk.io
    DATABASE_URL=tyk-ai-studio.db
    DATABASE_TYPE=sqlite
    TYK_AI_SECRET_KEY=a35b3f7b0fb4dd3a048ba4fc6e9fe0a8cb804d7884c62b6b2ea09c99612c4405
    FILTER_SIGNUP_DOMAINS=tyk.io
    TYK_AI_LICENSE=XXXX
   

   Note: PostgreSQL is strongly recommended for production use. SQLite is only suitable for development and testing.

​

Starting the Service

1. Start the services using Docker Compose:
   docker compose up -d
   
2. Verify that the services are running:
   docker compose ps
   

​

Accessing the Portal

• Access the AI Portal interface at: http://localhost:8080
• Access the Gateway at: http://localhost:9090

​

Monitoring Logs

docker compose logs -f

​

Stopping the Service

docker compose down

​

Method 2: Package Installation

1. Add the Tyk package repository:
   # For Ubuntu/Debian systems
   curl -fsSL https://packagecloud.io/tyk/tyk-ee/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/tyk-ee-archive-keyring.gpg
   echo "deb [signed-by=/usr/share/keyrings/tyk-ee-archive-keyring.gpg] https://packagecloud.io/tyk/tyk-ee/ubuntu/ $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/tyk-ee.list
   
   # For RHEL/CentOS systems
   curl -s https://packagecloud.io/install/repositories/tyk/tyk-ee/script.rpm.sh | sudo bash
   
2. Install the package:
   # For Ubuntu/Debian
   sudo apt update
   sudo apt install tyk-ai-studio
   
   # For RHEL/CentOS
   sudo yum install tyk-ai-studio
   
3. Configure the application:
   sudo nano /etc/tyk-ai-studio/.env
   
   Add your configuration (similar to Docker Compose example above). Ensure you configure PostgreSQL for production:
   DATABASE_URL=postgres://username:password@localhost:5432/tyk_ai_studio
   DATABASE_TYPE=postgres
   TYK_AI_LICENSE=your-license-key-here
   # ... other configuration options
   

   Note: The TYK_AI_LICENSE environment variable is required for the service to start. Contact support@tyk.io or your account manager if you need to obtain a license.

4. Start the service:
   sudo systemctl enable tyk-ai-studio
   sudo systemctl start tyk-ai-studio
   
5. Check service status:
   sudo systemctl status tyk-ai-studio
   

​

Service Components

• Tyk AI Studio Service: The main AI Portal application
  • Runs on ports 8080 (web interface) and 9090 (gateway server)
  • Connects to PostgreSQL for data storage
  • Uses environment variables for configuration
• PostgreSQL Database:
  • Stores application data
  • Uses default credentials (configurable via environment variables)

​

First User Registration

1. Access the application: Open your browser and navigate to http://localhost:8080
2. Register with admin email: Use the EXACT email address you set in the ADMIN_EMAIL environment variable
3. Complete registration: The first user who registers with the admin email will automatically become the administrator
   Important: The first user registration must use the same email address specified in the ADMIN_EMAIL environment variable. This user will have full administrative privileges.

​

Next Steps

1. Configure your first LLM: Add connections to AI providers like OpenAI, Anthropic, or Azure OpenAI
2. Set up user management: Create additional users and configure permissions
3. Explore the AI Portal: Try the chat interface and explore available tools

​

Troubleshooting

1. Check that all required ports (8080, 9090) are available
2. Ensure your .env file contains valid API keys and the correct ADMIN_EMAIL
3. Verify that Docker and Docker Compose are properly installed
4. Check the logs for any error messages: docker compose logs -f
5. Registration issues: Make sure you’re using the exact email address from ADMIN_EMAIL