Skip to content

Latest commit

 

History

History
108 lines (72 loc) · 1.82 KB

testing.md

File metadata and controls

108 lines (72 loc) · 1.82 KB

Testing Guide

How to test Jan Server on Windows, Linux, and macOS.


Quick Start

Run All Tests

make test-all

Specific Test Suites

make test-auth           # Authentication tests
make test-conversation   # Conversation tests
make test-response       # Response API tests
make test-media          # Media API tests
make test-mcp            # MCP Tools tests

Unit Tests

go test ./services/llm-api/...
go test ./services/response-api/...

Integration Testing

jan-cli api-test Collections

Test collections are located in tests/e2e/automation/collections/ and can be run via:

make test-all            # Run all integration tests
make test-auth           # Auth tests (guest-login, API keys, token refresh)
make test-conversation  # Conversation CRUD, messages
make test-response       # Tool orchestration
make test-media          # File uploads
make test-mcp            # MCP tool execution

Platform-Specific Notes

Linux (Ubuntu/Debian)

Full Docker support. All tests pass.

macOS

Requires Docker Desktop or Colima:

# Install Colima
brew install docker colima

# Start with resources
colima start --cpu 4 --memory 8 --disk 100

Windows

Windows CI focuses on CLI and build verification. Full Docker tests run on Ubuntu.


Troubleshooting

Permission Denied on tools/jan-cli.sh

chmod +x tools/jan-cli.sh

Docker Commands Fail

# Check Docker is running
docker ps

# Linux: Add user to docker group
sudo usermod -aG docker $USER

Build Failures

make clean-build
make build-llm-api
go mod download
go mod verify

Related Documentation