Installation Guide

Setup BYKT

Get BYKT running in minutes with Docker. No complex setup required.

1 Prerequisites

Docker

Container runtime for running BYKT services.

Get Docker

Ollama

Local LLM runtime for AI features.

Get Ollama

Pull the required models

# LLM for chat and reasoning
ollama pull qwen2.5:7b

# Embedding model for semantic search and classification
ollama pull nomic-embed-text-v2-moe:latest

2 Install BYKT

Bash

# Download and install
curl -sSL https://raw.githubusercontent.com/dx111ge/bykt/main/install.sh | bash

# Navigate to directory and start
cd bykt
docker compose -f docker-compose.prod.yml up -d

PowerShell

# Download and install
irm https://raw.githubusercontent.com/dx111ge/bykt/main/install.ps1 | iex

# Navigate to directory and start
cd bykt
docker compose -f docker-compose.prod.yml up -d

That's it!

The script downloads config files, generates secure secrets, and you're ready to go.

3 Access BYKT

Open in your browser:

http://127.0.0.1

Username

admin

Password

admin

Tip

Use 127.0.0.1 instead of localhost to avoid IPv6 connection issues.

Troubleshooting

Image pull fails (EOF/network errors)

Retry the command, or pull images separately:

                                docker pull dx111ge/bykt-backend:latest
docker pull dx111ge/bykt-frontend:latest
                            

Ollama not connecting

Ensure Ollama is running: ollama serve
Linux users: Edit .env and set OLLAMA_BASE_URL=http://YOUR_HOST_IP:11434

Stop or reset BYKT

Stop BYKT:

docker compose -f docker-compose.prod.yml down

Reset all data:

docker compose -f docker-compose.prod.yml down -v

Ready to explore?

Learn about BYKT's core concepts and features.

First Steps Guide