@fredlackey/devutils 0.0.1 → 0.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -5
- package/package.json +1 -1
- package/src/commands/install.js +374 -36
- package/src/installs/adobe-creative-cloud.js +527 -25
- package/src/installs/adobe-creative-cloud.md +605 -0
- package/src/installs/appcleaner.js +303 -26
- package/src/installs/appcleaner.md +699 -0
- package/src/installs/apt-transport-https.js +390 -0
- package/src/installs/apt-transport-https.md +678 -0
- package/src/installs/atomicparsley.js +624 -26
- package/src/installs/atomicparsley.md +795 -0
- package/src/installs/aws-cli.js +779 -26
- package/src/installs/aws-cli.md +727 -0
- package/src/installs/balena-etcher.js +688 -26
- package/src/installs/balena-etcher.md +761 -0
- package/src/installs/bambu-studio.js +912 -26
- package/src/installs/bambu-studio.md +780 -0
- package/src/installs/bash-completion.js +554 -23
- package/src/installs/bash-completion.md +833 -0
- package/src/installs/bash.js +399 -26
- package/src/installs/bash.md +993 -0
- package/src/installs/beyond-compare.js +585 -26
- package/src/installs/beyond-compare.md +813 -0
- package/src/installs/build-essential.js +511 -26
- package/src/installs/build-essential.md +977 -0
- package/src/installs/ca-certificates.js +618 -0
- package/src/installs/ca-certificates.md +937 -0
- package/src/installs/caffeine.js +490 -26
- package/src/installs/caffeine.md +839 -0
- package/src/installs/camtasia.js +577 -25
- package/src/installs/camtasia.md +762 -0
- package/src/installs/chatgpt.js +458 -26
- package/src/installs/chatgpt.md +814 -0
- package/src/installs/chocolatey.js +447 -0
- package/src/installs/chocolatey.md +661 -0
- package/src/installs/chrome-canary.js +472 -26
- package/src/installs/chrome-canary.md +641 -0
- package/src/installs/chromium.js +645 -26
- package/src/installs/chromium.md +838 -0
- package/src/installs/claude-code.js +558 -26
- package/src/installs/claude-code.md +1173 -0
- package/src/installs/curl.js +361 -26
- package/src/installs/curl.md +714 -0
- package/src/installs/cursor.js +561 -26
- package/src/installs/cursor.md +970 -0
- package/src/installs/dbschema.js +674 -26
- package/src/installs/dbschema.md +925 -0
- package/src/installs/dependencies.md +435 -0
- package/src/installs/development-tools.js +600 -0
- package/src/installs/development-tools.md +977 -0
- package/src/installs/docker.js +1010 -25
- package/src/installs/docker.md +1109 -0
- package/src/installs/drawio.js +1001 -26
- package/src/installs/drawio.md +795 -0
- package/src/installs/elmedia-player.js +328 -25
- package/src/installs/elmedia-player.md +556 -0
- package/src/installs/ffmpeg.js +870 -25
- package/src/installs/ffmpeg.md +852 -0
- package/src/installs/file.js +464 -0
- package/src/installs/file.md +987 -0
- package/src/installs/gemini-cli.js +793 -26
- package/src/installs/gemini-cli.md +1153 -0
- package/src/installs/git.js +382 -26
- package/src/installs/git.md +907 -0
- package/src/installs/gitego.js +931 -26
- package/src/installs/gitego.md +1172 -0
- package/src/installs/go.js +913 -26
- package/src/installs/go.md +958 -0
- package/src/installs/google-chrome.js +801 -25
- package/src/installs/google-chrome.md +862 -0
- package/src/installs/gpg.js +412 -73
- package/src/installs/gpg.md +1056 -0
- package/src/installs/homebrew.js +1015 -26
- package/src/installs/homebrew.md +988 -0
- package/src/installs/imageoptim.js +950 -26
- package/src/installs/imageoptim.md +1119 -0
- package/src/installs/installers.json +2297 -0
- package/src/installs/jq.js +382 -26
- package/src/installs/jq.md +809 -0
- package/src/installs/keyboard-maestro.js +701 -26
- package/src/installs/keyboard-maestro.md +825 -0
- package/src/installs/latex.js +771 -26
- package/src/installs/latex.md +1095 -0
- package/src/installs/lftp.js +338 -26
- package/src/installs/lftp.md +907 -0
- package/src/installs/lsb-release.js +346 -0
- package/src/installs/lsb-release.md +814 -0
- package/src/installs/messenger.js +829 -26
- package/src/installs/messenger.md +900 -0
- package/src/installs/microsoft-office.js +550 -26
- package/src/installs/microsoft-office.md +760 -0
- package/src/installs/microsoft-teams.js +782 -25
- package/src/installs/microsoft-teams.md +886 -0
- package/src/installs/node.js +886 -26
- package/src/installs/node.md +1153 -0
- package/src/installs/nordpass.js +698 -26
- package/src/installs/nordpass.md +921 -0
- package/src/installs/nvm.js +977 -26
- package/src/installs/nvm.md +1057 -0
- package/src/installs/openssh.js +734 -64
- package/src/installs/openssh.md +1056 -0
- package/src/installs/pandoc.js +644 -26
- package/src/installs/pandoc.md +1036 -0
- package/src/installs/pinentry.js +492 -26
- package/src/installs/pinentry.md +1142 -0
- package/src/installs/pngyu.js +851 -26
- package/src/installs/pngyu.md +896 -0
- package/src/installs/postman.js +781 -26
- package/src/installs/postman.md +940 -0
- package/src/installs/procps.js +425 -0
- package/src/installs/procps.md +851 -0
- package/src/installs/safari-tech-preview.js +355 -25
- package/src/installs/safari-tech-preview.md +533 -0
- package/src/installs/sfnt2woff.js +640 -26
- package/src/installs/sfnt2woff.md +795 -0
- package/src/installs/shellcheck.js +463 -26
- package/src/installs/shellcheck.md +1005 -0
- package/src/installs/slack.js +722 -25
- package/src/installs/slack.md +865 -0
- package/src/installs/snagit.js +566 -25
- package/src/installs/snagit.md +844 -0
- package/src/installs/software-properties-common.js +372 -0
- package/src/installs/software-properties-common.md +805 -0
- package/src/installs/spotify.js +858 -25
- package/src/installs/spotify.md +901 -0
- package/src/installs/studio-3t.js +803 -26
- package/src/installs/studio-3t.md +918 -0
- package/src/installs/sublime-text.js +780 -25
- package/src/installs/sublime-text.md +914 -0
- package/src/installs/superwhisper.js +687 -25
- package/src/installs/superwhisper.md +630 -0
- package/src/installs/tailscale.js +727 -26
- package/src/installs/tailscale.md +1100 -0
- package/src/installs/tar.js +389 -0
- package/src/installs/tar.md +946 -0
- package/src/installs/termius.js +780 -26
- package/src/installs/termius.md +844 -0
- package/src/installs/terraform.js +761 -26
- package/src/installs/terraform.md +899 -0
- package/src/installs/tidal.js +752 -25
- package/src/installs/tidal.md +864 -0
- package/src/installs/tmux.js +328 -26
- package/src/installs/tmux.md +1030 -0
- package/src/installs/tree.js +393 -26
- package/src/installs/tree.md +833 -0
- package/src/installs/unzip.js +460 -0
- package/src/installs/unzip.md +879 -0
- package/src/installs/vim.js +403 -26
- package/src/installs/vim.md +1040 -0
- package/src/installs/vlc.js +803 -26
- package/src/installs/vlc.md +927 -0
- package/src/installs/vscode.js +825 -26
- package/src/installs/vscode.md +1002 -0
- package/src/installs/wget.js +415 -0
- package/src/installs/wget.md +791 -0
- package/src/installs/whatsapp.js +710 -25
- package/src/installs/whatsapp.md +854 -0
- package/src/installs/winpty.js +352 -0
- package/src/installs/winpty.md +620 -0
- package/src/installs/woff2.js +535 -26
- package/src/installs/woff2.md +977 -0
- package/src/installs/wsl.js +572 -0
- package/src/installs/wsl.md +699 -0
- package/src/installs/xcode-clt.js +520 -0
- package/src/installs/xcode-clt.md +351 -0
- package/src/installs/xcode.js +542 -26
- package/src/installs/xcode.md +573 -0
- package/src/installs/yarn.js +806 -26
- package/src/installs/yarn.md +1074 -0
- package/src/installs/yq.js +636 -26
- package/src/installs/yq.md +944 -0
- package/src/installs/yt-dlp.js +683 -26
- package/src/installs/yt-dlp.md +946 -0
- package/src/installs/yum-utils.js +297 -0
- package/src/installs/yum-utils.md +648 -0
- package/src/installs/zoom.js +740 -25
- package/src/installs/zoom.md +884 -0
- package/src/scripts/README.md +567 -45
- package/src/scripts/STATUS.md +208 -0
- package/src/scripts/afk.js +395 -7
- package/src/scripts/backup-all.js +731 -9
- package/src/scripts/backup-source.js +711 -8
- package/src/scripts/brewd.js +373 -7
- package/src/scripts/brewi.js +505 -9
- package/src/scripts/brewr.js +512 -9
- package/src/scripts/brews.js +462 -9
- package/src/scripts/brewu.js +488 -7
- package/src/scripts/c.js +185 -7
- package/src/scripts/ccurl.js +325 -8
- package/src/scripts/certbot-crontab-init.js +488 -8
- package/src/scripts/certbot-init.js +641 -9
- package/src/scripts/ch.js +339 -7
- package/src/scripts/claude-danger.js +253 -8
- package/src/scripts/clean-dev.js +419 -8
- package/src/scripts/clear-dns-cache.js +525 -7
- package/src/scripts/clone.js +417 -7
- package/src/scripts/code-all.js +420 -7
- package/src/scripts/count-files.js +195 -8
- package/src/scripts/count-folders.js +195 -8
- package/src/scripts/count.js +248 -8
- package/src/scripts/d.js +203 -7
- package/src/scripts/datauri.js +373 -8
- package/src/scripts/delete-files.js +363 -7
- package/src/scripts/docker-clean.js +410 -8
- package/src/scripts/dp.js +426 -7
- package/src/scripts/e.js +375 -9
- package/src/scripts/empty-trash.js +497 -7
- package/src/scripts/evm.js +428 -9
- package/src/scripts/fetch-github-repos.js +441 -10
- package/src/scripts/get-channel.js +329 -8
- package/src/scripts/get-course.js +384 -11
- package/src/scripts/get-dependencies.js +290 -9
- package/src/scripts/get-folder.js +783 -10
- package/src/scripts/get-tunes.js +411 -10
- package/src/scripts/get-video.js +352 -9
- package/src/scripts/git-backup.js +561 -9
- package/src/scripts/git-clone.js +477 -9
- package/src/scripts/git-pup.js +303 -7
- package/src/scripts/git-push.js +380 -8
- package/src/scripts/h.js +607 -9
- package/src/scripts/hide-desktop-icons.js +483 -7
- package/src/scripts/hide-hidden-files.js +522 -7
- package/src/scripts/install-dependencies-from.js +440 -9
- package/src/scripts/ips.js +647 -10
- package/src/scripts/iso.js +354 -8
- package/src/scripts/killni.js +561 -7
- package/src/scripts/ll.js +451 -8
- package/src/scripts/local-ip.js +310 -8
- package/src/scripts/m.js +508 -8
- package/src/scripts/map.js +293 -8
- package/src/scripts/mkd.js +287 -7
- package/src/scripts/ncu-update-all.js +441 -8
- package/src/scripts/nginx-init.js +702 -12
- package/src/scripts/npmi.js +366 -7
- package/src/scripts/o.js +495 -8
- package/src/scripts/org-by-date.js +321 -7
- package/src/scripts/p.js +208 -7
- package/src/scripts/packages.js +313 -8
- package/src/scripts/path.js +209 -7
- package/src/scripts/ports.js +582 -8
- package/src/scripts/q.js +290 -8
- package/src/scripts/refresh-files.js +378 -10
- package/src/scripts/remove-smaller-files.js +500 -8
- package/src/scripts/rename-files-with-date.js +517 -9
- package/src/scripts/resize-image.js +523 -9
- package/src/scripts/rm-safe.js +653 -8
- package/src/scripts/s.js +525 -9
- package/src/scripts/set-git-public.js +349 -7
- package/src/scripts/show-desktop-icons.js +459 -7
- package/src/scripts/show-hidden-files.js +456 -7
- package/src/scripts/tpa.js +265 -8
- package/src/scripts/tpo.js +264 -7
- package/src/scripts/u.js +489 -7
- package/src/scripts/vpush.js +422 -8
- package/src/scripts/y.js +267 -7
- package/src/utils/common/os.js +94 -2
- package/src/utils/ubuntu/apt.js +13 -7
|
@@ -0,0 +1,795 @@
|
|
|
1
|
+
# Installing Draw.io
|
|
2
|
+
|
|
3
|
+
## Overview
|
|
4
|
+
|
|
5
|
+
Draw.io (also known as diagrams.net) is a free, open-source diagramming application for creating flowcharts, process diagrams, org charts, UML diagrams, ER diagrams, network diagrams, and more. The desktop application is built on Electron and provides a security-first approach where all diagram data remains local - no data is ever sent externally.
|
|
6
|
+
|
|
7
|
+
Key features:
|
|
8
|
+
- **Offline-first**: Works completely offline after installation
|
|
9
|
+
- **Privacy-focused**: No analytics or external data transmission
|
|
10
|
+
- **Cross-platform**: Available for macOS, Windows, and Linux
|
|
11
|
+
- **Free and open-source**: Licensed under Apache 2.0
|
|
12
|
+
|
|
13
|
+
This guide documents Draw.io Desktop installation across all supported platforms.
|
|
14
|
+
|
|
15
|
+
## Dependencies
|
|
16
|
+
|
|
17
|
+
### macOS (Homebrew)
|
|
18
|
+
- **Required:**
|
|
19
|
+
- Homebrew - Install via `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"` or run `dev install homebrew`
|
|
20
|
+
- **Optional:** None
|
|
21
|
+
- **Auto-installed:** All application dependencies are automatically handled by the Homebrew cask installation process
|
|
22
|
+
|
|
23
|
+
### Ubuntu (APT/Snap)
|
|
24
|
+
- **Required:**
|
|
25
|
+
- snapd - Install via `sudo apt-get update && sudo apt-get install -y snapd` (automatically installed by the installer if missing)
|
|
26
|
+
- **Optional:** None
|
|
27
|
+
- **Auto-installed:** snapd package manager will be installed automatically if not present via `sudo apt-get install -y snapd`
|
|
28
|
+
|
|
29
|
+
### Raspberry Pi OS (APT/Snap)
|
|
30
|
+
- **Required:**
|
|
31
|
+
- curl - Install via `sudo apt-get install -y curl` (usually pre-installed)
|
|
32
|
+
- **Optional:**
|
|
33
|
+
- snapd - Install via `sudo apt-get install -y snapd` (preferred installation method, but installer falls back to .deb package if unavailable)
|
|
34
|
+
- **Auto-installed:** When using .deb package fallback, apt will automatically install any missing package dependencies
|
|
35
|
+
|
|
36
|
+
### Amazon Linux (DNF/YUM)
|
|
37
|
+
- **Required:**
|
|
38
|
+
- wget - Install via `sudo dnf install -y wget` (AL2023) or `sudo yum install -y wget` (AL2)
|
|
39
|
+
- curl - Install via `sudo dnf install -y curl` (AL2023) or `sudo yum install -y curl` (AL2)
|
|
40
|
+
- libxkbfile - Install via `sudo dnf install -y libxkbfile` (AL2023) or `sudo yum install -y libxkbfile` (AL2)
|
|
41
|
+
- libsecret - Install via `sudo dnf install -y libsecret` (AL2023) or `sudo yum install -y libsecret` (AL2)
|
|
42
|
+
- nss - Install via `sudo dnf install -y nss` (AL2023) or `sudo yum install -y nss` (AL2)
|
|
43
|
+
- gtk3 - Install via `sudo dnf install -y gtk3` (AL2023) or `sudo yum install -y gtk3` (AL2)
|
|
44
|
+
- libdrm - Install via `sudo dnf install -y libdrm` (AL2023) or `sudo yum install -y libdrm` (AL2)
|
|
45
|
+
- mesa-libgbm - Install via `sudo dnf install -y mesa-libgbm` (AL2023) or `sudo yum install -y mesa-libgbm` (AL2)
|
|
46
|
+
- alsa-lib - Install via `sudo dnf install -y alsa-lib` (AL2023) or `sudo yum install -y alsa-lib` (AL2)
|
|
47
|
+
- **Optional:** None
|
|
48
|
+
- **Auto-installed:** None (all dependencies must be manually installed before running Draw.io)
|
|
49
|
+
|
|
50
|
+
### Windows (Chocolatey/winget)
|
|
51
|
+
- **Required:**
|
|
52
|
+
- Chocolatey - Install via PowerShell (Administrator): `Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))`
|
|
53
|
+
- **Optional:** None
|
|
54
|
+
- **Auto-installed:** All application dependencies are automatically handled by the Chocolatey package installation process
|
|
55
|
+
|
|
56
|
+
### Git Bash (Manual/Portable)
|
|
57
|
+
- **Required:**
|
|
58
|
+
- curl - Usually pre-installed with Git for Windows
|
|
59
|
+
- **Optional:**
|
|
60
|
+
- unzip - Install via Git for Windows package manager or use PowerShell's Expand-Archive as fallback
|
|
61
|
+
- **Auto-installed:** None
|
|
62
|
+
|
|
63
|
+
## Prerequisites
|
|
64
|
+
|
|
65
|
+
Before installing Draw.io on any platform, ensure:
|
|
66
|
+
|
|
67
|
+
1. **Internet connectivity** - Required to download installation packages
|
|
68
|
+
2. **Administrative privileges** - Required for system-wide installation
|
|
69
|
+
3. **Sufficient disk space** - Approximately 500 MB free space recommended
|
|
70
|
+
|
|
71
|
+
## Platform-Specific Installation
|
|
72
|
+
|
|
73
|
+
### macOS (Homebrew)
|
|
74
|
+
|
|
75
|
+
#### Prerequisites
|
|
76
|
+
|
|
77
|
+
- macOS 12 (Monterey) or later
|
|
78
|
+
- Homebrew package manager installed
|
|
79
|
+
- Apple Silicon (M1/M2/M3/M4) or Intel processor
|
|
80
|
+
|
|
81
|
+
If Homebrew is not installed, install it first:
|
|
82
|
+
|
|
83
|
+
```bash
|
|
84
|
+
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
#### Installation Steps
|
|
88
|
+
|
|
89
|
+
Run the following command to install Draw.io Desktop:
|
|
90
|
+
|
|
91
|
+
```bash
|
|
92
|
+
brew install --quiet --cask drawio
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
The `--quiet` flag suppresses non-essential output, and `--cask` specifies the graphical application version. Homebrew automatically detects your processor architecture (Intel or Apple Silicon) and installs the appropriate version.
|
|
96
|
+
|
|
97
|
+
#### Verification
|
|
98
|
+
|
|
99
|
+
Confirm the installation succeeded by launching the application:
|
|
100
|
+
|
|
101
|
+
```bash
|
|
102
|
+
open -a "draw.io"
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
Alternatively, verify the application exists:
|
|
106
|
+
|
|
107
|
+
```bash
|
|
108
|
+
ls /Applications | grep -i draw
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
Expected output:
|
|
112
|
+
|
|
113
|
+
```
|
|
114
|
+
draw.io.app
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
#### Troubleshooting
|
|
118
|
+
|
|
119
|
+
**Problem**: `Error: Cask 'drawio' is not installed`
|
|
120
|
+
|
|
121
|
+
**Solution**: The cask name may have changed. Search for the current name:
|
|
122
|
+
|
|
123
|
+
```bash
|
|
124
|
+
brew search drawio
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
**Problem**: Application fails to open with "damaged" warning
|
|
128
|
+
|
|
129
|
+
**Solution**: Remove the quarantine attribute:
|
|
130
|
+
|
|
131
|
+
```bash
|
|
132
|
+
xattr -cr /Applications/draw.io.app
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
**Problem**: Homebrew is not in PATH after installation
|
|
136
|
+
|
|
137
|
+
**Solution**: Add Homebrew to your PATH. For Apple Silicon Macs:
|
|
138
|
+
|
|
139
|
+
```bash
|
|
140
|
+
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
|
|
141
|
+
eval "$(/opt/homebrew/bin/brew shellenv)"
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
---
|
|
145
|
+
|
|
146
|
+
### Ubuntu/Debian (Snap)
|
|
147
|
+
|
|
148
|
+
#### Prerequisites
|
|
149
|
+
|
|
150
|
+
- Ubuntu 16.04 LTS or later, or Debian 9 or later
|
|
151
|
+
- snapd package manager (pre-installed on Ubuntu 16.04+)
|
|
152
|
+
- sudo privileges
|
|
153
|
+
|
|
154
|
+
Snap is the recommended installation method for Ubuntu/Debian as it provides automatic updates and consistent behavior across distributions.
|
|
155
|
+
|
|
156
|
+
First, ensure snapd is installed and up to date:
|
|
157
|
+
|
|
158
|
+
```bash
|
|
159
|
+
sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
|
|
160
|
+
sudo DEBIAN_FRONTEND=noninteractive apt-get install -y snapd
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
#### Installation Steps
|
|
164
|
+
|
|
165
|
+
Run the following command to install Draw.io:
|
|
166
|
+
|
|
167
|
+
```bash
|
|
168
|
+
sudo snap install drawio
|
|
169
|
+
```
|
|
170
|
+
|
|
171
|
+
Snap handles all dependencies automatically and will keep Draw.io updated in the background.
|
|
172
|
+
|
|
173
|
+
#### Verification
|
|
174
|
+
|
|
175
|
+
Confirm the installation succeeded:
|
|
176
|
+
|
|
177
|
+
```bash
|
|
178
|
+
snap list drawio
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
Expected output (version numbers may vary):
|
|
182
|
+
|
|
183
|
+
```
|
|
184
|
+
Name Version Rev Tracking Publisher Notes
|
|
185
|
+
drawio 28.2.5 123 latest/stable jgraph -
|
|
186
|
+
```
|
|
187
|
+
|
|
188
|
+
Launch Draw.io to verify it works:
|
|
189
|
+
|
|
190
|
+
```bash
|
|
191
|
+
drawio &
|
|
192
|
+
```
|
|
193
|
+
|
|
194
|
+
Or from the application menu, search for "draw.io" or "diagrams.net".
|
|
195
|
+
|
|
196
|
+
#### Troubleshooting
|
|
197
|
+
|
|
198
|
+
**Problem**: `error: snap "drawio" is not available on stable for this architecture`
|
|
199
|
+
|
|
200
|
+
**Solution**: The Snap package may not support your CPU architecture. Use the alternative .deb installation method:
|
|
201
|
+
|
|
202
|
+
```bash
|
|
203
|
+
# Download the latest .deb package
|
|
204
|
+
curl -s https://api.github.com/repos/jgraph/drawio-desktop/releases/latest | grep "browser_download_url.*amd64.*\.deb" | cut -d '"' -f 4 | xargs -I {} curl -L -o /tmp/drawio.deb {}
|
|
205
|
+
# Install the package
|
|
206
|
+
sudo DEBIAN_FRONTEND=noninteractive apt-get install -y /tmp/drawio.deb
|
|
207
|
+
```
|
|
208
|
+
|
|
209
|
+
**Problem**: Draw.io cannot access files in certain directories
|
|
210
|
+
|
|
211
|
+
**Solution**: Snap applications have limited file system access by default. Grant additional permissions:
|
|
212
|
+
|
|
213
|
+
```bash
|
|
214
|
+
sudo snap connect drawio:removable-media
|
|
215
|
+
```
|
|
216
|
+
|
|
217
|
+
**Problem**: `snap: command not found`
|
|
218
|
+
|
|
219
|
+
**Solution**: Install snapd:
|
|
220
|
+
|
|
221
|
+
```bash
|
|
222
|
+
sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
|
|
223
|
+
sudo DEBIAN_FRONTEND=noninteractive apt-get install -y snapd
|
|
224
|
+
sudo systemctl enable --now snapd.socket
|
|
225
|
+
sudo ln -s /var/lib/snapd/snap /snap
|
|
226
|
+
```
|
|
227
|
+
|
|
228
|
+
Log out and log back in for PATH changes to take effect.
|
|
229
|
+
|
|
230
|
+
---
|
|
231
|
+
|
|
232
|
+
### Raspberry Pi OS (Snap or Manual)
|
|
233
|
+
|
|
234
|
+
#### Prerequisites
|
|
235
|
+
|
|
236
|
+
- Raspberry Pi OS (64-bit recommended) - Bookworm or Bullseye
|
|
237
|
+
- Raspberry Pi 3B+ or later (64-bit capable hardware)
|
|
238
|
+
- At least 2 GB RAM
|
|
239
|
+
- sudo privileges
|
|
240
|
+
|
|
241
|
+
First, verify your architecture:
|
|
242
|
+
|
|
243
|
+
```bash
|
|
244
|
+
uname -m
|
|
245
|
+
```
|
|
246
|
+
|
|
247
|
+
- `aarch64` = 64-bit (recommended, more packages available)
|
|
248
|
+
- `armv7l` = 32-bit (limited package availability)
|
|
249
|
+
|
|
250
|
+
**Important**: Draw.io Desktop ARM64 packages are available from GitHub releases. Snap packages may have limited ARM support.
|
|
251
|
+
|
|
252
|
+
#### Installation Steps
|
|
253
|
+
|
|
254
|
+
**For 64-bit Raspberry Pi OS (aarch64):**
|
|
255
|
+
|
|
256
|
+
Install via Snap (if available for your architecture):
|
|
257
|
+
|
|
258
|
+
```bash
|
|
259
|
+
# Install and configure snapd
|
|
260
|
+
sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
|
|
261
|
+
sudo DEBIAN_FRONTEND=noninteractive apt-get install -y snapd
|
|
262
|
+
sudo reboot
|
|
263
|
+
```
|
|
264
|
+
|
|
265
|
+
After reboot:
|
|
266
|
+
|
|
267
|
+
```bash
|
|
268
|
+
sudo snap install core
|
|
269
|
+
sudo snap install drawio
|
|
270
|
+
```
|
|
271
|
+
|
|
272
|
+
**Alternative: Install from .deb package (Recommended for ARM64):**
|
|
273
|
+
|
|
274
|
+
If Snap does not work on your architecture, download and install the ARM64 .deb package directly:
|
|
275
|
+
|
|
276
|
+
```bash
|
|
277
|
+
# Download the latest ARM64 .deb package
|
|
278
|
+
curl -s https://api.github.com/repos/jgraph/drawio-desktop/releases/latest | grep "browser_download_url.*arm64.*\.deb" | cut -d '"' -f 4 | xargs -I {} curl -L -o /tmp/drawio-arm64.deb {}
|
|
279
|
+
|
|
280
|
+
# Install the package and resolve dependencies
|
|
281
|
+
sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
|
|
282
|
+
sudo DEBIAN_FRONTEND=noninteractive apt-get install -y /tmp/drawio-arm64.deb
|
|
283
|
+
```
|
|
284
|
+
|
|
285
|
+
**For 32-bit Raspberry Pi OS (armv7l):**
|
|
286
|
+
|
|
287
|
+
Draw.io Desktop does not officially provide 32-bit ARM packages. Use the web version instead:
|
|
288
|
+
|
|
289
|
+
1. Open Chromium browser on your Raspberry Pi
|
|
290
|
+
2. Navigate to https://app.diagrams.net
|
|
291
|
+
3. The web application provides the same functionality as the desktop app
|
|
292
|
+
|
|
293
|
+
#### Verification
|
|
294
|
+
|
|
295
|
+
For Snap installation:
|
|
296
|
+
|
|
297
|
+
```bash
|
|
298
|
+
snap list drawio
|
|
299
|
+
```
|
|
300
|
+
|
|
301
|
+
For .deb installation:
|
|
302
|
+
|
|
303
|
+
```bash
|
|
304
|
+
dpkg -l | grep drawio
|
|
305
|
+
```
|
|
306
|
+
|
|
307
|
+
Launch Draw.io:
|
|
308
|
+
|
|
309
|
+
```bash
|
|
310
|
+
drawio &
|
|
311
|
+
```
|
|
312
|
+
|
|
313
|
+
#### Troubleshooting
|
|
314
|
+
|
|
315
|
+
**Problem**: Snap installation fails with architecture error
|
|
316
|
+
|
|
317
|
+
**Solution**: Use the .deb package installation method described above for ARM64, or use the web version for 32-bit systems.
|
|
318
|
+
|
|
319
|
+
**Problem**: Application is slow or unresponsive
|
|
320
|
+
|
|
321
|
+
**Solution**: Draw.io is an Electron application which can be resource-intensive. Ensure you have adequate RAM (2 GB minimum, 4 GB recommended) and consider closing other applications.
|
|
322
|
+
|
|
323
|
+
**Problem**: Dependency errors when installing .deb package
|
|
324
|
+
|
|
325
|
+
**Solution**: Fix broken dependencies:
|
|
326
|
+
|
|
327
|
+
```bash
|
|
328
|
+
sudo DEBIAN_FRONTEND=noninteractive apt-get install -y -f
|
|
329
|
+
```
|
|
330
|
+
|
|
331
|
+
---
|
|
332
|
+
|
|
333
|
+
### Amazon Linux (RPM Manual Installation)
|
|
334
|
+
|
|
335
|
+
#### Prerequisites
|
|
336
|
+
|
|
337
|
+
- Amazon Linux 2023 (AL2023) or Amazon Linux 2 (AL2)
|
|
338
|
+
- sudo privileges
|
|
339
|
+
- curl and wget installed
|
|
340
|
+
|
|
341
|
+
**Note**: Draw.io is not available in Amazon Linux's default repositories. Install the RPM package directly from GitHub releases.
|
|
342
|
+
|
|
343
|
+
#### Installation Steps
|
|
344
|
+
|
|
345
|
+
**For Amazon Linux 2023 (DNF):**
|
|
346
|
+
|
|
347
|
+
```bash
|
|
348
|
+
# Install required dependencies
|
|
349
|
+
sudo dnf install -y wget curl libxkbfile libsecret nss
|
|
350
|
+
|
|
351
|
+
# Download the latest x86_64 RPM package
|
|
352
|
+
curl -s https://api.github.com/repos/jgraph/drawio-desktop/releases/latest | grep "browser_download_url.*x86_64.*\.rpm" | cut -d '"' -f 4 | xargs -I {} curl -L -o /tmp/drawio.rpm {}
|
|
353
|
+
|
|
354
|
+
# Install the package
|
|
355
|
+
sudo dnf install -y /tmp/drawio.rpm
|
|
356
|
+
```
|
|
357
|
+
|
|
358
|
+
**For Amazon Linux 2 (YUM):**
|
|
359
|
+
|
|
360
|
+
```bash
|
|
361
|
+
# Install required dependencies
|
|
362
|
+
sudo yum install -y wget curl libxkbfile libsecret nss
|
|
363
|
+
|
|
364
|
+
# Download the latest x86_64 RPM package
|
|
365
|
+
curl -s https://api.github.com/repos/jgraph/drawio-desktop/releases/latest | grep "browser_download_url.*x86_64.*\.rpm" | cut -d '"' -f 4 | xargs -I {} curl -L -o /tmp/drawio.rpm {}
|
|
366
|
+
|
|
367
|
+
# Install the package
|
|
368
|
+
sudo yum install -y /tmp/drawio.rpm
|
|
369
|
+
```
|
|
370
|
+
|
|
371
|
+
#### Verification
|
|
372
|
+
|
|
373
|
+
Confirm the installation succeeded:
|
|
374
|
+
|
|
375
|
+
```bash
|
|
376
|
+
rpm -qa | grep drawio
|
|
377
|
+
```
|
|
378
|
+
|
|
379
|
+
Expected output (version numbers may vary):
|
|
380
|
+
|
|
381
|
+
```
|
|
382
|
+
drawio-29.2.9-1.x86_64
|
|
383
|
+
```
|
|
384
|
+
|
|
385
|
+
Launch Draw.io (requires X11 display):
|
|
386
|
+
|
|
387
|
+
```bash
|
|
388
|
+
drawio &
|
|
389
|
+
```
|
|
390
|
+
|
|
391
|
+
#### Troubleshooting
|
|
392
|
+
|
|
393
|
+
**Problem**: Missing library dependencies
|
|
394
|
+
|
|
395
|
+
**Solution**: Install common Electron dependencies:
|
|
396
|
+
|
|
397
|
+
```bash
|
|
398
|
+
# For AL2023
|
|
399
|
+
sudo dnf install -y gtk3 libdrm mesa-libgbm alsa-lib
|
|
400
|
+
|
|
401
|
+
# For AL2
|
|
402
|
+
sudo yum install -y gtk3 libdrm mesa-libgbm alsa-lib
|
|
403
|
+
```
|
|
404
|
+
|
|
405
|
+
**Problem**: "cannot open display" error
|
|
406
|
+
|
|
407
|
+
**Solution**: Draw.io is a GUI application requiring a graphical environment. On headless servers, use X11 forwarding:
|
|
408
|
+
|
|
409
|
+
```bash
|
|
410
|
+
ssh -X user@amazon-linux-host
|
|
411
|
+
drawio &
|
|
412
|
+
```
|
|
413
|
+
|
|
414
|
+
Or use the web version at https://app.diagrams.net for server environments.
|
|
415
|
+
|
|
416
|
+
**Problem**: RPM verification fails
|
|
417
|
+
|
|
418
|
+
**Solution**: Import the GPG key or skip verification (less secure):
|
|
419
|
+
|
|
420
|
+
```bash
|
|
421
|
+
sudo rpm --import https://github.com/jgraph.gpg
|
|
422
|
+
# Or skip verification
|
|
423
|
+
sudo rpm -ivh --nosignature /tmp/drawio.rpm
|
|
424
|
+
```
|
|
425
|
+
|
|
426
|
+
---
|
|
427
|
+
|
|
428
|
+
### Windows (Chocolatey)
|
|
429
|
+
|
|
430
|
+
#### Prerequisites
|
|
431
|
+
|
|
432
|
+
- Windows 10 version 1809 or later (64-bit), or Windows 11
|
|
433
|
+
- Administrator PowerShell or Command Prompt
|
|
434
|
+
- Chocolatey package manager installed
|
|
435
|
+
|
|
436
|
+
If Chocolatey is not installed, install it first by running this command in an Administrator PowerShell:
|
|
437
|
+
|
|
438
|
+
```powershell
|
|
439
|
+
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
|
|
440
|
+
```
|
|
441
|
+
|
|
442
|
+
#### Installation Steps
|
|
443
|
+
|
|
444
|
+
Run the following command in an Administrator PowerShell or Command Prompt:
|
|
445
|
+
|
|
446
|
+
```powershell
|
|
447
|
+
choco install drawio -y
|
|
448
|
+
```
|
|
449
|
+
|
|
450
|
+
The `-y` flag automatically confirms all prompts, enabling fully non-interactive installation. The Chocolatey package uses the `/S` (silent) flag internally for the installer.
|
|
451
|
+
|
|
452
|
+
#### Verification
|
|
453
|
+
|
|
454
|
+
Confirm the installation succeeded:
|
|
455
|
+
|
|
456
|
+
```powershell
|
|
457
|
+
choco list drawio
|
|
458
|
+
```
|
|
459
|
+
|
|
460
|
+
Expected output (version numbers may vary):
|
|
461
|
+
|
|
462
|
+
```
|
|
463
|
+
drawio 29.2.9
|
|
464
|
+
1 packages installed.
|
|
465
|
+
```
|
|
466
|
+
|
|
467
|
+
Launch Draw.io from the Start Menu or via command line:
|
|
468
|
+
|
|
469
|
+
```powershell
|
|
470
|
+
start "" "C:\Program Files\draw.io\draw.io.exe"
|
|
471
|
+
```
|
|
472
|
+
|
|
473
|
+
#### Troubleshooting
|
|
474
|
+
|
|
475
|
+
**Problem**: Installation fails with access denied error
|
|
476
|
+
|
|
477
|
+
**Solution**: Ensure you are running PowerShell or Command Prompt as Administrator. Right-click the terminal icon and select "Run as administrator".
|
|
478
|
+
|
|
479
|
+
**Problem**: `choco: command not found`
|
|
480
|
+
|
|
481
|
+
**Solution**: Chocolatey was not installed correctly or PATH was not updated. Close and reopen PowerShell, or reinstall Chocolatey.
|
|
482
|
+
|
|
483
|
+
**Problem**: Application does not appear after installation
|
|
484
|
+
|
|
485
|
+
**Solution**: The installer may require a system restart. If that does not help, verify the installation:
|
|
486
|
+
|
|
487
|
+
```powershell
|
|
488
|
+
Get-ChildItem "C:\Program Files\draw.io"
|
|
489
|
+
```
|
|
490
|
+
|
|
491
|
+
---
|
|
492
|
+
|
|
493
|
+
### WSL (Ubuntu)
|
|
494
|
+
|
|
495
|
+
#### Prerequisites
|
|
496
|
+
|
|
497
|
+
- Windows 10 version 2004 or higher, or Windows 11
|
|
498
|
+
- WSL 2 enabled with Ubuntu distribution installed
|
|
499
|
+
- sudo privileges within WSL
|
|
500
|
+
- X11 server running on Windows (for GUI applications)
|
|
501
|
+
|
|
502
|
+
**Important**: Draw.io is a GUI application. Running it in WSL requires an X11 server on Windows to display the window.
|
|
503
|
+
|
|
504
|
+
#### Installation Steps
|
|
505
|
+
|
|
506
|
+
**Step 1: Install an X11 server on Windows**
|
|
507
|
+
|
|
508
|
+
Install VcXsrv or similar X11 server on Windows:
|
|
509
|
+
|
|
510
|
+
```powershell
|
|
511
|
+
# Run in Windows PowerShell as Administrator
|
|
512
|
+
choco install vcxsrv -y
|
|
513
|
+
```
|
|
514
|
+
|
|
515
|
+
Launch XLaunch from the Start Menu with default settings (Multiple windows, Start no client, Disable access control).
|
|
516
|
+
|
|
517
|
+
**Step 2: Configure WSL for X11 display**
|
|
518
|
+
|
|
519
|
+
In WSL Ubuntu, configure the DISPLAY variable:
|
|
520
|
+
|
|
521
|
+
```bash
|
|
522
|
+
# For WSL 2
|
|
523
|
+
echo 'export DISPLAY=$(grep -m 1 nameserver /etc/resolv.conf | awk "{print \$2}"):0' >> ~/.bashrc
|
|
524
|
+
source ~/.bashrc
|
|
525
|
+
```
|
|
526
|
+
|
|
527
|
+
**Step 3: Install Draw.io via Snap**
|
|
528
|
+
|
|
529
|
+
```bash
|
|
530
|
+
# Install snapd if not present
|
|
531
|
+
sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
|
|
532
|
+
sudo DEBIAN_FRONTEND=noninteractive apt-get install -y snapd
|
|
533
|
+
|
|
534
|
+
# Install Draw.io
|
|
535
|
+
sudo snap install drawio
|
|
536
|
+
```
|
|
537
|
+
|
|
538
|
+
#### Verification
|
|
539
|
+
|
|
540
|
+
Confirm the installation succeeded:
|
|
541
|
+
|
|
542
|
+
```bash
|
|
543
|
+
snap list drawio
|
|
544
|
+
```
|
|
545
|
+
|
|
546
|
+
Launch Draw.io (ensure X11 server is running on Windows):
|
|
547
|
+
|
|
548
|
+
```bash
|
|
549
|
+
drawio &
|
|
550
|
+
```
|
|
551
|
+
|
|
552
|
+
A Draw.io window should appear on your Windows desktop.
|
|
553
|
+
|
|
554
|
+
#### Troubleshooting
|
|
555
|
+
|
|
556
|
+
**Problem**: `Error: cannot open display`
|
|
557
|
+
|
|
558
|
+
**Solution**: Ensure the X11 server is running on Windows and DISPLAY is set correctly:
|
|
559
|
+
|
|
560
|
+
```bash
|
|
561
|
+
echo $DISPLAY
|
|
562
|
+
```
|
|
563
|
+
|
|
564
|
+
If empty or incorrect, set it manually:
|
|
565
|
+
|
|
566
|
+
```bash
|
|
567
|
+
export DISPLAY=$(grep -m 1 nameserver /etc/resolv.conf | awk '{print $2}'):0
|
|
568
|
+
```
|
|
569
|
+
|
|
570
|
+
**Problem**: Snap does not work in WSL
|
|
571
|
+
|
|
572
|
+
**Solution**: Snap requires systemd which is not enabled by default in WSL. Enable systemd:
|
|
573
|
+
|
|
574
|
+
```bash
|
|
575
|
+
echo -e "[boot]\nsystemd=true" | sudo tee /etc/wsl.conf
|
|
576
|
+
```
|
|
577
|
+
|
|
578
|
+
Then restart WSL from Windows PowerShell:
|
|
579
|
+
|
|
580
|
+
```powershell
|
|
581
|
+
wsl --shutdown
|
|
582
|
+
```
|
|
583
|
+
|
|
584
|
+
Re-open WSL and retry the Snap installation.
|
|
585
|
+
|
|
586
|
+
**Problem**: Window appears but is blank or crashes
|
|
587
|
+
|
|
588
|
+
**Solution**: Try running with software rendering:
|
|
589
|
+
|
|
590
|
+
```bash
|
|
591
|
+
drawio --disable-gpu &
|
|
592
|
+
```
|
|
593
|
+
|
|
594
|
+
---
|
|
595
|
+
|
|
596
|
+
### Git Bash (Windows Portable Installation)
|
|
597
|
+
|
|
598
|
+
#### Prerequisites
|
|
599
|
+
|
|
600
|
+
- Windows 10 or Windows 11 (64-bit)
|
|
601
|
+
- Git Bash installed (comes with Git for Windows)
|
|
602
|
+
- Internet connection to download the portable package
|
|
603
|
+
|
|
604
|
+
**Note**: Git Bash runs on Windows, so the primary installation method is the Windows Chocolatey installation (see Windows section). However, if you cannot use Chocolatey or need a portable installation, follow these steps.
|
|
605
|
+
|
|
606
|
+
#### Installation Steps
|
|
607
|
+
|
|
608
|
+
Download and extract the portable Windows ZIP package:
|
|
609
|
+
|
|
610
|
+
```bash
|
|
611
|
+
# Create a directory for portable applications
|
|
612
|
+
mkdir -p ~/portable-apps
|
|
613
|
+
|
|
614
|
+
# Download the latest Windows ZIP (portable version)
|
|
615
|
+
curl -L -o /tmp/drawio.zip "$(curl -s https://api.github.com/repos/jgraph/drawio-desktop/releases/latest | grep 'browser_download_url.*windows\.zip' | head -1 | cut -d '"' -f 4)"
|
|
616
|
+
|
|
617
|
+
# Extract to portable apps directory
|
|
618
|
+
unzip -q /tmp/drawio.zip -d ~/portable-apps/drawio
|
|
619
|
+
|
|
620
|
+
# Clean up
|
|
621
|
+
rm /tmp/drawio.zip
|
|
622
|
+
```
|
|
623
|
+
|
|
624
|
+
Add an alias for easy access from Git Bash:
|
|
625
|
+
|
|
626
|
+
```bash
|
|
627
|
+
echo 'alias drawio="~/portable-apps/drawio/draw.io.exe"' >> ~/.bashrc
|
|
628
|
+
source ~/.bashrc
|
|
629
|
+
```
|
|
630
|
+
|
|
631
|
+
#### Verification
|
|
632
|
+
|
|
633
|
+
Confirm the installation succeeded:
|
|
634
|
+
|
|
635
|
+
```bash
|
|
636
|
+
ls ~/portable-apps/drawio/
|
|
637
|
+
```
|
|
638
|
+
|
|
639
|
+
Expected output should include `draw.io.exe` and supporting files.
|
|
640
|
+
|
|
641
|
+
Launch Draw.io:
|
|
642
|
+
|
|
643
|
+
```bash
|
|
644
|
+
drawio &
|
|
645
|
+
```
|
|
646
|
+
|
|
647
|
+
Or directly:
|
|
648
|
+
|
|
649
|
+
```bash
|
|
650
|
+
~/portable-apps/drawio/draw.io.exe &
|
|
651
|
+
```
|
|
652
|
+
|
|
653
|
+
#### Troubleshooting
|
|
654
|
+
|
|
655
|
+
**Problem**: `unzip: command not found`
|
|
656
|
+
|
|
657
|
+
**Solution**: Install unzip via Git Bash's package manager or use Windows built-in extraction:
|
|
658
|
+
|
|
659
|
+
```bash
|
|
660
|
+
# Alternative using PowerShell from Git Bash
|
|
661
|
+
powershell -command "Expand-Archive -Path '/tmp/drawio.zip' -DestinationPath '$HOME/portable-apps/drawio'"
|
|
662
|
+
```
|
|
663
|
+
|
|
664
|
+
**Problem**: Permission denied when running the executable
|
|
665
|
+
|
|
666
|
+
**Solution**: Windows may have blocked the downloaded file. Unblock it:
|
|
667
|
+
|
|
668
|
+
```bash
|
|
669
|
+
powershell -command "Unblock-File -Path '$HOME/portable-apps/drawio/draw.io.exe'"
|
|
670
|
+
```
|
|
671
|
+
|
|
672
|
+
**Problem**: PATH issues with spaces in directory names
|
|
673
|
+
|
|
674
|
+
**Solution**: Ensure the path is quoted correctly in aliases and commands. Use Windows-style paths if needed:
|
|
675
|
+
|
|
676
|
+
```bash
|
|
677
|
+
alias drawio='"/c/Users/YourName/portable-apps/drawio/draw.io.exe"'
|
|
678
|
+
```
|
|
679
|
+
|
|
680
|
+
---
|
|
681
|
+
|
|
682
|
+
## Post-Installation Configuration
|
|
683
|
+
|
|
684
|
+
After installing Draw.io on any platform, consider these optional configurations.
|
|
685
|
+
|
|
686
|
+
### Setting Default File Format
|
|
687
|
+
|
|
688
|
+
Draw.io supports multiple file formats. To set a default:
|
|
689
|
+
|
|
690
|
+
1. Open Draw.io
|
|
691
|
+
2. Go to File > Properties
|
|
692
|
+
3. Set your preferred default format (`.drawio`, `.drawio.xml`, `.drawio.svg`, `.drawio.png`)
|
|
693
|
+
|
|
694
|
+
### Configuring Automatic Updates
|
|
695
|
+
|
|
696
|
+
**macOS (Homebrew)**: Updates are manual. Run periodically:
|
|
697
|
+
|
|
698
|
+
```bash
|
|
699
|
+
brew upgrade --cask drawio
|
|
700
|
+
```
|
|
701
|
+
|
|
702
|
+
**Linux (Snap)**: Updates are automatic via snapd.
|
|
703
|
+
|
|
704
|
+
**Windows (Chocolatey)**: Run periodically:
|
|
705
|
+
|
|
706
|
+
```powershell
|
|
707
|
+
choco upgrade drawio -y
|
|
708
|
+
```
|
|
709
|
+
|
|
710
|
+
### Disabling Update Checks
|
|
711
|
+
|
|
712
|
+
If you prefer to control updates manually, you can disable automatic update checks:
|
|
713
|
+
|
|
714
|
+
1. Open Draw.io
|
|
715
|
+
2. Go to Help > Check for Updates
|
|
716
|
+
3. Disable automatic checking
|
|
717
|
+
|
|
718
|
+
### Integrating with Version Control
|
|
719
|
+
|
|
720
|
+
Draw.io files (`.drawio`) are XML-based and can be version-controlled with Git. For better diff support:
|
|
721
|
+
|
|
722
|
+
1. Save diagrams as `.drawio.svg` or `.drawio.png` for visual diffs
|
|
723
|
+
2. Or use `.drawio.xml` for text-based diffs
|
|
724
|
+
|
|
725
|
+
---
|
|
726
|
+
|
|
727
|
+
## Common Issues
|
|
728
|
+
|
|
729
|
+
### Issue: Application Takes Long Time to Start
|
|
730
|
+
|
|
731
|
+
**Symptoms**: Draw.io shows a blank window or loading indicator for an extended period.
|
|
732
|
+
|
|
733
|
+
**Solutions**:
|
|
734
|
+
|
|
735
|
+
- Disable hardware acceleration: Launch with `--disable-gpu` flag
|
|
736
|
+
- Clear application cache (location varies by platform)
|
|
737
|
+
- Ensure sufficient system resources are available
|
|
738
|
+
|
|
739
|
+
### Issue: Cannot Open Files from Network Drives
|
|
740
|
+
|
|
741
|
+
**Symptoms**: Error when trying to open diagrams stored on network shares.
|
|
742
|
+
|
|
743
|
+
**Solutions**:
|
|
744
|
+
|
|
745
|
+
- Copy the file locally first, then open it
|
|
746
|
+
- On Linux Snap installations, connect the removable-media interface:
|
|
747
|
+
|
|
748
|
+
```bash
|
|
749
|
+
sudo snap connect drawio:removable-media
|
|
750
|
+
```
|
|
751
|
+
|
|
752
|
+
### Issue: Export to PDF Fails
|
|
753
|
+
|
|
754
|
+
**Symptoms**: PDF export produces blank or corrupted files.
|
|
755
|
+
|
|
756
|
+
**Solutions**:
|
|
757
|
+
|
|
758
|
+
- Ensure the diagram is not empty
|
|
759
|
+
- Try exporting to PNG first, then convert to PDF
|
|
760
|
+
- Update to the latest version of Draw.io
|
|
761
|
+
|
|
762
|
+
### Issue: Fonts Appear Incorrect
|
|
763
|
+
|
|
764
|
+
**Symptoms**: Diagram text uses incorrect or fallback fonts.
|
|
765
|
+
|
|
766
|
+
**Solutions**:
|
|
767
|
+
|
|
768
|
+
- Install the required fonts on your system
|
|
769
|
+
- Use web-safe fonts for maximum compatibility
|
|
770
|
+
- Embed fonts when exporting (File > Export As > Advanced Options)
|
|
771
|
+
|
|
772
|
+
### Issue: Slow Performance with Large Diagrams
|
|
773
|
+
|
|
774
|
+
**Symptoms**: Application becomes sluggish with complex diagrams.
|
|
775
|
+
|
|
776
|
+
**Solutions**:
|
|
777
|
+
|
|
778
|
+
- Split large diagrams into multiple pages
|
|
779
|
+
- Reduce the use of complex shapes and gradients
|
|
780
|
+
- Increase available system memory
|
|
781
|
+
- Disable "Connection Arrows" for complex diagrams
|
|
782
|
+
|
|
783
|
+
---
|
|
784
|
+
|
|
785
|
+
## References
|
|
786
|
+
|
|
787
|
+
- [Draw.io Official Website](https://www.drawio.com/)
|
|
788
|
+
- [Draw.io Desktop GitHub Repository](https://github.com/jgraph/drawio-desktop)
|
|
789
|
+
- [Draw.io Desktop Releases](https://github.com/jgraph/drawio-desktop/releases)
|
|
790
|
+
- [Homebrew Cask - drawio](https://formulae.brew.sh/cask/drawio)
|
|
791
|
+
- [Snap Store - drawio](https://snapcraft.io/drawio)
|
|
792
|
+
- [Chocolatey Package - drawio](https://community.chocolatey.org/packages/drawio)
|
|
793
|
+
- [Draw.io Desktop Documentation](https://www.drawio.com/blog/diagrams-offline)
|
|
794
|
+
- [Installing Snap on Raspberry Pi OS](https://snapcraft.io/docs/installing-snap-on-raspbian)
|
|
795
|
+
- [Draw.io Silent Installation Guide](https://silentinstallhq.com/draw-io-silent-install-how-to-guide/)
|