Caisy

Key Features

• Visual content modeling interface for creating custom content types without code
• High-performance GraphQL API with automatic query optimization and caching
• Built-in asset management with automatic image optimization and WebP conversion
• Multi-language content support with translation workflows
• Real-time collaborative editing with conflict resolution
• Component-based content architecture for reusable content blocks
• Advanced content relationships and reference management
• Webhook support for triggering builds and integrations on content changes

Common Use Cases

• 1Developing headless websites and web applications with complex content requirements
• 2Building multi-platform mobile apps that need centralized content management
• 3Creating marketing websites with frequent content updates from non-technical teams
• 4Prototyping client projects that require visual content modeling capabilities
• 5Developing e-commerce product catalogs with rich media and variant management
• 6Building documentation sites with collaborative editing workflows
• 7Creating multi-brand digital experiences with shared content libraries

Prerequisites

• Docker and Docker Compose installed on your development machine
• At least 4GB RAM available for PostgreSQL and Caisy containers
• Port 3000 available for Caisy web interface access
• Basic understanding of GraphQL for content consumption
• Environment file with DB_PASSWORD variable configured
• Familiarity with headless CMS concepts and API-driven development

docker-compose.yml

1services: 
2  caisy: 
3    image: caisy/caisy:latest
4    container_name: caisy
5    restart: unless-stopped
6    environment: 
7      DATABASE_URL: postgres://caisy:${DB_PASSWORD}@postgres:5432/caisy
8    ports: 
9      - "3000:3000"
10    depends_on: 
11      - postgres
12    networks: 
13      - caisy-network
14
15  postgres: 
16    image: postgres:16-alpine
17    container_name: caisy-postgres
18    environment: 
19      POSTGRES_USER: caisy
20      POSTGRES_PASSWORD: ${DB_PASSWORD}
21      POSTGRES_DB: caisy
22    volumes: 
23      - postgres_data:/var/lib/postgresql/data
24    networks: 
25      - caisy-network
26
27volumes: 
28  postgres_data: 
29
30networks: 
31  caisy-network: 
32    driver: bridge

.env Template

1DB_PASSWORD=changeme

Usage Notes

Individual Services(2 services)

Copy individual services to mix and match with your existing compose files.

caisy:
  image: caisy/caisy:latest
  container_name: caisy
  restart: unless-stopped
  environment:
    DATABASE_URL: postgres://caisy:${DB_PASSWORD}@postgres:5432/caisy
  ports:
    - "3000:3000"
  depends_on:
    - postgres
  networks:
    - caisy-network

postgres:
  image: postgres:16-alpine
  container_name: caisy-postgres
  environment:
    POSTGRES_USER: caisy
    POSTGRES_PASSWORD: ${DB_PASSWORD}
    POSTGRES_DB: caisy
  volumes:
    - postgres_data:/var/lib/postgresql/data
  networks:
    - caisy-network

Quick Start

1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4  caisy:
5    image: caisy/caisy:latest
6    container_name: caisy
7    restart: unless-stopped
8    environment:
9      DATABASE_URL: postgres://caisy:${DB_PASSWORD}@postgres:5432/caisy
10    ports:
11      - "3000:3000"
12    depends_on:
13      - postgres
14    networks:
15      - caisy-network
16
17  postgres:
18    image: postgres:16-alpine
19    container_name: caisy-postgres
20    environment:
21      POSTGRES_USER: caisy
22      POSTGRES_PASSWORD: ${DB_PASSWORD}
23      POSTGRES_DB: caisy
24    volumes:
25      - postgres_data:/var/lib/postgresql/data
26    networks:
27      - caisy-network
28
29volumes:
30  postgres_data:
31
32networks:
33  caisy-network:
34    driver: bridge
35EOF
36
37# 2. Create the .env file
38cat > .env << 'EOF'
39DB_PASSWORD=changeme
40EOF
41
42# 3. Start the services
43docker compose up -d
44
45# 4. View logs
46docker compose logs -f

One-Liner

Run this command to download and set up the recipe in one step:

1curl -fsSL https://docker.recipes/api/recipes/contentful-like-caisy/run | bash

Troubleshooting