Getting Started

DevWorkspace Pro is a desktop app for your web projects. It works with projects in all stacks, for example .NET, Node.js, Go, Python, Rust, Ruby and PHP. All projects show in one list. A project can run in DDEV, Laravel Sail, Docker Compose, or with the tools on your computer. See Projects and DDEV Projects.

Requirements

DevWorkspace Pro needs only a supported operating system. The other requirements apply to DDEV projects:

• DDEV.
• A container runtime that DDEV supports, for example OrbStack or Docker Desktop.

Without DDEV, you can use all the tools that do not need containers, for example Terminal, Files, Git, GitHub, Focus Pad and AI Sessions.

Supported operating systems

• macOS 12 or later
• Windows 10 or later, with PowerShell 7 or later
• Linux with glibc 2.35 or later, for example Ubuntu 22.04+, Debian 12+, Fedora 36+ or Arch. Older glibc (Debian 11, RHEL 8 and 9) and Alpine (musl) are not supported.

On Windows, DDEV can run in WSL2. To select the distribution, go to Preferences → General → WSL Distribution.

Download

Buy a license. After payment, you get an email with your license code and a download link. You need the license code on first launch.

Install

macOS

Drag DevWorkspace Pro from the disk image to the Applications folder.

Windows

Run the installer. You can change the install folder.

Linux

Two packages are available:

Package	Use on
.deb	Debian, Ubuntu, Linux Mint, Pop!_OS
AppImage	Any distribution with glibc 2.35 or later

WARNING

Do not install the .deb package and the AppImage at the same time. They use the same settings, and only one can run.

.deb package

1. Open a terminal in your download folder.
2. Run this command:

sudo apt install ./"DevWorkspace Pro-Linux-<version>-amd64.deb"

apt also installs the recommended xdotool package. Voice-to-Text uses it to type text.

App Center shows a "third-party package" warning for each .deb package from outside the Ubuntu archive. This is expected.

To upgrade, run the same apt command with the new file. App Center does not upgrade a local .deb package.

The .deb package also installs the devworkspacepro command, which starts the app from a terminal. To uninstall it, run sudo apt remove devworkspacepro.

AppImage

The AppImage needs no install step and no libfuse2.

1. Move the file to ~/Applications. Keep it there. The app menu entry points to this path.
2. Make the file executable:

chmod +x ~/Applications/DevWorkspace\ Pro-Linux-*.AppImage

3. Run the file.

On first run, the app adds DevWorkspace Pro with its icon to the app menu (~/.local/share/applications). You can then pin it to the dock. If you move the file, run it one time again to update the menu entry.

To uninstall, delete the file. The menu entry then hides itself. Optional: also remove these files:

• ~/.local/share/applications/devworkspacepro.desktop
• ~/.local/share/icons/hicolor/*/apps/devworkspacepro.png

Wayland

On a Wayland session, the app runs through XWayland (X11). This is intentional. On first launch, the AppImage can restart one time.

Activate your license

On first launch, enter the license code from your email.

Activation needs an internet connection. After activation, the app keeps the license on your computer and checks it online from time to time. If the app cannot connect to the server, it keeps the last known license state. After a license expires, you have a 14-day grace period to renew it.

On first open, the app shows the DDEV projects that DDEV already knows. See DDEV Projects.

To create a project, click New Project. Select what you are building, then how you run it, for example DDEV, Laravel Sail, Docker Compose, Local PHP or the .NET CLI. See Create a project.

Updates

The app checks for updates in the background. It downloads updates in the background. When a download is complete, click Restart now to install it, or click Later. If you click Later, the update installs the next time you quit the app.

To check now, click Check for Update… in the app menu (macOS) or the Tools menu (Windows and Linux).

If an automatic check fails, the app shows nothing. If a check that you start from the menu fails, the app shows a short message.

Troubleshooting

Linux AppImage does not start (sandbox error)

The AppImage adds --no-sandbox automatically when your system blocks user namespaces (for example, Ubuntu 24.04 and later).

If it still does not start, run it from a terminal and send the output to support:

~/Applications/DevWorkspace\ Pro-Linux-*.AppImage

Get help

• Discussions, issues and feature requests are in the community repository.
• For license problems, email support.