Cockpit CMS

Key Features

• JSON-based Collections system for structured content with custom field types and validation rules
• Singletons for global configuration data like site settings, SEO metadata, and application constants
• MongoDB aggregation pipeline integration for complex content queries and analytics
• Token-based REST API authentication with granular permission controls per collection
• Asset management with automatic image resizing and WebP conversion capabilities
• Real-time content preview with webhook support for triggering builds in static site generators
• Custom field components including repeaters, galleries, and markdown editors with live preview
• MongoDB Change Streams integration for real-time content synchronization across multiple frontends

Common Use Cases

• 1Headless blog or magazine platform feeding content to React, Vue.js, or Next.js frontends
• 2Mobile app content management where iOS and Android apps consume the same content API
• 3Multi-site content distribution serving different brands or regions from centralized content
• 4E-commerce product catalog management for custom shopping experiences built with modern frameworks
• 5Documentation systems where technical writers manage content consumed by developer portals
• 6Digital agency client projects requiring custom designs without CMS theme limitations
• 7Static site generator content source for Gatsby, Nuxt, or Eleventy build processes

Prerequisites

• Minimum 1GB RAM for combined Cockpit and MongoDB operations with small datasets
• Port 8080 available for Cockpit admin interface and API endpoints
• Understanding of REST API concepts for frontend integration and token management
• Basic JSON knowledge for content structure design and API response handling
• MongoDB query familiarity for advanced content filtering and aggregation operations
• Frontend development skills in JavaScript frameworks for headless implementation

docker-compose.yml

1services: 
2  cockpit: 
3    image: agentejo/cockpit:latest
4    container_name: cockpit
5    restart: unless-stopped
6    volumes: 
7      - cockpit_data:/var/www/html/storage
8    ports: 
9      - "8080:80"
10    networks: 
11      - cockpit-network
12
13  mongodb: 
14    image: mongo:7
15    container_name: cockpit-mongodb
16    volumes: 
17      - mongodb_data:/data/db
18    networks: 
19      - cockpit-network
20
21volumes: 
22  cockpit_data: 
23  mongodb_data: 
24
25networks: 
26  cockpit-network: 
27    driver: bridge

.env Template

1# Default credentials: admin / admin

Usage Notes

Individual Services(2 services)

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

cockpit:
  image: agentejo/cockpit:latest
  container_name: cockpit
  restart: unless-stopped
  volumes:
    - cockpit_data:/var/www/html/storage
  ports:
    - "8080:80"
  networks:
    - cockpit-network

mongodb:
  image: mongo:7
  container_name: cockpit-mongodb
  volumes:
    - mongodb_data:/data/db
  networks:
    - cockpit-network

Quick Start

1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4  cockpit:
5    image: agentejo/cockpit:latest
6    container_name: cockpit
7    restart: unless-stopped
8    volumes:
9      - cockpit_data:/var/www/html/storage
10    ports:
11      - "8080:80"
12    networks:
13      - cockpit-network
14
15  mongodb:
16    image: mongo:7
17    container_name: cockpit-mongodb
18    volumes:
19      - mongodb_data:/data/db
20    networks:
21      - cockpit-network
22
23volumes:
24  cockpit_data:
25  mongodb_data:
26
27networks:
28  cockpit-network:
29    driver: bridge
30EOF
31
32# 2. Create the .env file
33cat > .env << 'EOF'
34# Default credentials: admin / admin
35EOF
36
37# 3. Start the services
38docker compose up -d
39
40# 4. View logs
41docker 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/cockpit-cms/run | bash

Troubleshooting