Logseq Sync Alternative

Key Features

• RFC 4918 compliant WebDAV server supporting standard file operations across all major operating systems
• HTTP Basic authentication with configurable username/password pairs for secure access control
• NGINX reverse proxy providing SSL/TLS termination and HTTP/2 support for encrypted synchronization
• Event-driven NGINX architecture optimizing performance for concurrent Logseq client connections
• WebDAV PROPFIND and PROPPATCH support enabling Logseq metadata synchronization and conflict resolution
• NGINX rate limiting and connection management preventing sync conflicts during high-frequency updates
• Cross-platform compatibility supporting Logseq desktop, mobile, and web clients simultaneously
• WebDAV LOCK/UNLOCK mechanisms ensuring data integrity during concurrent editing sessions

Common Use Cases

• 1Personal knowledge management with Logseq synchronization across desktop and mobile devices
• 2Small research teams sharing and collaborating on interconnected notes and documentation
• 3Academic institutions providing students with self-hosted note synchronization infrastructure
• 4Consulting firms maintaining client confidentiality by keeping project notes on private servers
• 5Privacy-focused individuals avoiding commercial sync services like iCloud or Dropbox for personal data
• 6Remote development teams synchronizing technical documentation and meeting notes across time zones
• 7Healthcare organizations maintaining HIPAA-compliant patient note synchronization for authorized staff

Prerequisites

• Minimum 256MB RAM for NGINX Alpine container and WebDAV server concurrent operation
• Ports 80, 443, and 8080 available for HTTP, HTTPS, and direct WebDAV access respectively
• SSL certificates configured for production HTTPS access (Let's Encrypt or commercial CA)
• Basic understanding of WebDAV protocol and Logseq sync configuration settings
• Network firewall rules allowing WebDAV traffic on configured ports from client devices
• WEBDAV_USER and WEBDAV_PASSWORD environment variables configured for authentication

docker-compose.yml

1services: 
2  webdav: 
3    image: bytemark/webdav:latest
4    ports: 
5      - "8080:80"
6    environment: 
7      AUTH_TYPE: Basic
8      USERNAME: ${WEBDAV_USER}
9      PASSWORD: ${WEBDAV_PASSWORD}
10    volumes: 
11      - webdav_data:/var/lib/dav
12    networks: 
13      - logseq-net
14    restart: unless-stopped
15
16  nginx: 
17    image: nginx:alpine
18    ports: 
19      - "80:80"
20      - "443:443"
21    volumes: 
22      - ./nginx.conf:/etc/nginx/nginx.conf:ro
23    depends_on: 
24      - webdav
25    networks: 
26      - logseq-net
27    restart: unless-stopped
28
29volumes: 
30  webdav_data: 
31
32networks: 
33  logseq-net: 
34    driver: bridge

.env Template

1# WebDAV Credentials
2WEBDAV_USER=logseq
3WEBDAV_PASSWORD=secure_password

Usage Notes

Individual Services(2 services)

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

webdav:
  image: bytemark/webdav:latest
  ports:
    - "8080:80"
  environment:
    AUTH_TYPE: Basic
    USERNAME: ${WEBDAV_USER}
    PASSWORD: ${WEBDAV_PASSWORD}
  volumes:
    - webdav_data:/var/lib/dav
  networks:
    - logseq-net
  restart: unless-stopped

nginx:
  image: nginx:alpine
  ports:
    - "80:80"
    - "443:443"
  volumes:
    - ./nginx.conf:/etc/nginx/nginx.conf:ro
  depends_on:
    - webdav
  networks:
    - logseq-net
  restart: unless-stopped

Quick Start

1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4  webdav:
5    image: bytemark/webdav:latest
6    ports:
7      - "8080:80"
8    environment:
9      AUTH_TYPE: Basic
10      USERNAME: ${WEBDAV_USER}
11      PASSWORD: ${WEBDAV_PASSWORD}
12    volumes:
13      - webdav_data:/var/lib/dav
14    networks:
15      - logseq-net
16    restart: unless-stopped
17
18  nginx:
19    image: nginx:alpine
20    ports:
21      - "80:80"
22      - "443:443"
23    volumes:
24      - ./nginx.conf:/etc/nginx/nginx.conf:ro
25    depends_on:
26      - webdav
27    networks:
28      - logseq-net
29    restart: unless-stopped
30
31volumes:
32  webdav_data:
33
34networks:
35  logseq-net:
36    driver: bridge
37EOF
38
39# 2. Create the .env file
40cat > .env << 'EOF'
41# WebDAV Credentials
42WEBDAV_USER=logseq
43WEBDAV_PASSWORD=secure_password
44EOF
45
46# 3. Start the services
47docker compose up -d
48
49# 4. View logs
50docker 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/logseq-sync-server/run | bash

Troubleshooting