Docker Configuration¶

Obelisk uses Docker for containerization of both the development environment and the production deployment.

Dockerfile¶

The main Dockerfile defines the container image for running Obelisk:

# View the Dockerfile contents
cat /workspaces/obelisk/Dockerfile

This file defines: - Base image selection - System dependencies installation - Python environment setup - Obelisk installation - Default command execution

Docker Compose Configuration¶

The docker-compose.yaml file orchestrates the complete Obelisk stack, including optional AI components:

# View the docker-compose.yaml contents
cat /workspaces/obelisk/docker-compose.yaml

Key services include: - obelisk: The main Obelisk documentation server - ollama: (Optional) AI model server for local embedding and inference - openwebui: (Optional) Web interface for interacting with AI models

Development Container¶

The .devcontainer directory contains configuration for VS Code's Development Containers feature:

devcontainer.json¶

# View the devcontainer.json contents
cat /workspaces/obelisk/.devcontainer/devcontainer.json

This file configures: - Development container settings - VS Code extensions to install - Port forwarding - Environment variables - Startup commands

Dockerfile (Dev)¶

# View the development container Dockerfile
cat /workspaces/obelisk/.devcontainer/Dockerfile

The development container Dockerfile includes: - Development-specific tools and dependencies - Debugging utilities - Additional build tools

Running with Docker¶

To run Obelisk using Docker:

Build the image:
```
docker build -t obelisk .
```
Run with Docker:
```
docker run -p 8000:8000 obelisk
```
Run with Docker Compose:
```
docker-compose up obelisk
```
Run the full stack with AI:
```
docker-compose up
```

Task Runner Integration¶

Docker commands are also available through the Task runner:

# Build Docker container
task docker-build

# Run with local volumes mounted
task docker-run

# Run Obelisk service only
task compose-obelisk

# Run full stack with Ollama and OpenWebUI
task compose