Diagrams.net Server

Key Features

• Real-time collaborative editing with live cursor tracking and instant synchronization across multiple users
• Built-in SSL/TLS encryption with automatic certificate generation for secure diagram access
• Native integration capabilities with Confluence, Jira, and other Atlassian products through REST APIs
• Extensive shape libraries including AWS, Azure, GCP, Cisco, and network topology icons
• Multiple export formats including PNG, JPEG, SVG, PDF, VSDX, and XML for maximum compatibility
• Plugin architecture supporting custom shape libraries and third-party integrations
• Version control integration with GitHub, GitLab, and other Git repositories for diagram versioning
• Offline editing capabilities with automatic synchronization when connection is restored

Common Use Cases

• 1Enterprise architecture teams documenting system designs and infrastructure topology with sensitive data requirements
• 2Software development teams creating UML diagrams, database schemas, and API documentation within private networks
• 3Network administrators mapping network topologies and documenting infrastructure changes for internal compliance
• 4Educational institutions providing students with unrestricted access to professional diagramming tools
• 5Healthcare organizations creating process flows and organizational charts while maintaining HIPAA compliance
• 6Government agencies requiring air-gapped diagramming solutions for classified or sensitive documentation
• 7Manufacturing companies documenting industrial processes and equipment layouts for internal quality systems

Prerequisites

• Docker Engine 20.10+ and Docker Compose V2 for container orchestration support
• Minimum 512MB RAM allocated to the container for optimal performance with multiple concurrent users
• Available port 8443 for HTTPS access, or alternative port mapping configuration
• Valid SSL certificate or acceptance of self-signed certificates for HTTPS functionality
• Basic understanding of certificate management and HTTPS configuration for production deployments
• Network access configuration if integrating with existing LDAP, Active Directory, or SSO systems

docker-compose.yml

1services: 
2  diagrams: 
3    image: jgraph/drawio:latest
4    container_name: diagrams-net
5    restart: unless-stopped
6    environment: 
7      PUBLIC_DNS: localhost
8      ORGANISATION_UNIT: IT
9      ORGANISATION: MyOrg
10      CITY: City
11      STATE: State
12      COUNTRY: US
13    ports: 
14      - "8443:8443"

.env Template

1# SSL certificates generated automatically

Usage Notes

Quick Start

1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4  diagrams:
5    image: jgraph/drawio:latest
6    container_name: diagrams-net
7    restart: unless-stopped
8    environment:
9      PUBLIC_DNS: localhost
10      ORGANISATION_UNIT: IT
11      ORGANISATION: MyOrg
12      CITY: City
13      STATE: State
14      COUNTRY: US
15    ports:
16      - "8443:8443"
17EOF
18
19# 2. Create the .env file
20cat > .env << 'EOF'
21# SSL certificates generated automatically
22EOF
23
24# 3. Start the services
25docker compose up -d
26
27# 4. View logs
28docker 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/diagrams-net/run | bash

Troubleshooting