Dokploy Development Environment

Quick setup guide for Fedora 43 laptop with Dokploy, NocoBase, and Twenty CRM.

Prerequisites

• Dokploy installed and running on port 3000
• Docker and Docker Compose installed
• User in docker group

Quick Start

1. Install Dev Manager Script

# Create folders
mkdir -p ~/dev/{projects,shared,scripts,dokploy-apps}

# Copy dev-manager.sh to ~/dev/scripts/
cp scripts/dev-manager.sh ~/dev/scripts/

# Make executable
chmod +x ~/dev/scripts/dev-manager.sh

# Add alias (zsh)
echo 'alias dev="~/dev/scripts/dev-manager.sh"' >> ~/.zshrc
source ~/.zshrc

# Test
dev help

2. Deploy NocoBase

Option A: Manual via Dokploy UI

1. Open http://localhost:3000
2. Create Project → "nocobase"
3. Create Service → Compose
4. Paste content from compose-files/nocobase-compose.yml
5. Deploy

Option B: Automated

cd automation
npm install
node deploy-nocobase.js

Access: http://localhost:13000

3. Deploy Twenty CRM

Option A: Manual via Dokploy UI

1. Open http://localhost:3000
2. Create Project → "twenty-crm"
3. Create Service → Compose
4. Paste content from compose-files/twenty-compose.yml
5. Deploy

Option B: Automated

cd automation
node deploy-twenty.js

Access: http://localhost:13001

Port Map

Service	Port
Dokploy	3000
NocoBase	13000
Twenty CRM	13001
Dev Projects	4000-4999

Commands

dev status   # Show containers
dev list     # List projects
dev ports    # Show port usage
dev dokploy  # Open dashboard

Files

├── PLAN.md              # Full context and plan
├── README.md            # This file
├── compose-files/
│   ├── nocobase-compose.yml
│   └── twenty-compose.yml
├── scripts/
│   └── dev-manager.sh
└── automation/
    ├── package.json
    ├── deploy-nocobase.js
    └── deploy-twenty.js