mirror of
https://github.com/instavm/open-skills.git
synced 2026-11-18 18:03:45 +00:00
3.0 KiB
3.0 KiB
Docker Multi-Platform Setup
This document explains how to set up Docker builds and deployment for Open-Skills across multiple platforms.
Required Secrets for GitHub Actions
To enable automatic Docker Hub publishing, add these secrets to your GitHub repository:
Setting up Docker Hub Secrets
-
Go to your Docker Hub account:
- Visit hub.docker.com
- Go to Account Settings → Security → New Access Token
- Create a token with Read, Write, Delete permissions
-
Add secrets to GitHub repository:
- Go to your GitHub repo → Settings → Secrets and variables → Actions
- Add these repository secrets:
DOCKER_USERNAME: your-dockerhub-username
DOCKER_TOKEN: your-dockerhub-access-token
Workflow Triggers
The Docker build workflow runs on:
- Push to main/develop: Builds and pushes
docker-latesttag - Pull Requests: Builds only (no push) for testing
- Releases: Builds and pushes version tags like
v1.0.0-docker
Docker Usage
Quick Start with Docker
# Run Open-Skills with Docker
docker run -d \
--name open-skills \
-p 8222:8222 \
-v ./uploads:/app/uploads \
bandarlabs/open-skills:latest
# Access MCP server
curl http://localhost:8222/mcp
Docker Compose (Recommended)
# Use the provided docker-compose.yml
docker compose up -d
# View logs
docker compose logs -f
# Stop service
docker compose down
Environment Variables
FASTMCP_HOST: Server host (default: 0.0.0.0)FASTMCP_PORT: Server port (default: 8222)
Platform Support
| Platform | Container Tool | Image Tag | Registry |
|---|---|---|---|
| macOS (Apple Silicon) | Apple container |
apple-latest |
OCI-compatible |
| Linux (x64/ARM64) | Docker | docker-latest |
Docker Hub |
| Windows | Docker Desktop | docker-latest |
Docker Hub |
Integration Examples
With Claude Desktop (Docker)
{
"mcpServers": {
"open-skills": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"-p", "8222:8222",
"-v", "./uploads:/app/uploads",
"bandarlabs/open-skills:latest"
]
}
}
}
With OpenAI Agents
# Update openai_client.py to use Docker endpoint
hostname = "localhost" # Instead of open-skills.local
address = "127.0.0.1"
url = f"http://{address}:8222/mcp"
Building Locally
# Standard Docker build
docker build -t open-skills-local .
# Multi-architecture build
docker buildx build --platform linux/amd64,linux/arm64 -t open-skills-multiarch .
Troubleshooting
Common Issues
- Port conflicts: Change port mapping
-p 8223:8222 - Volume permissions: Ensure
./uploadsdirectory exists and is writable - Memory issues: Add memory limits
--memory 4g
Health Checks
# Check container status
docker ps
# Check logs
docker logs open-skills
# Test MCP endpoint
curl -f http://localhost:8222/mcp || echo "MCP not ready"