Licensing & Requirements
Is DevOpsProjManager free to use commercially?
Yes. DevOpsProjManager is released under the MIT license, which allows
unrestricted commercial and personal use, modification, and distribution.
Which Python version is required?
Python 3.11 or newer. Python 3.13 is recommended for best performance.
PySide6 6.6+ is also required and is installed automatically via pip.
Installation
I get a long-path error when installing on Windows. What should I do?
Create the virtual environment at a short path, for example
python -m venv D:\dop_env. This avoids the Windows 260-character
path limit that affects some PySide6 QML resource files during installation.
Where are my project settings stored?
Settings are stored in
app.config.json in the OS-appropriate
application data directory:
Windows: %APPDATA%\DevOpsProjManager\,
macOS: ~/Library/Application Support/DevOpsProjManager/,
Linux: ~/.config/DevOpsProjManager/.
Security
Are my FTP passwords stored in plain text?
No. FTP passwords are encrypted with AES-256 (Fernet / cryptography library)
before being written to disk. A machine-local encryption key is stored in a
hidden key file in the same config directory.
Projects & Folders
Can I import existing PowerShell sync configs?
Yes. Click Import Config on the dashboard and select any
*.config.json file created by the sync-project.ps1
workflow. The WorkDir, GitDir and Services entries are mapped automatically.
How many folders can a project have?
Up to 5 environment folders per project: Dev, Staging, Stable, Production, and
one Custom folder. Each folder can track an independent Git branch.
Sync & Backups
What happens if a sync goes wrong?
A versioned zip backup of the target folder is created automatically before
every sync operation. Backups are stored in the app data directory and are
accessible via the Backups tab in the project view. Click
Restore to recover any previous version.
Does the diff viewer support binary files?
Binary files are detected automatically. The viewer shows whether binary files
are identical or differ, but does not attempt to display their content.
Services & Git
Can I run build and test commands?
Yes. The Services tab supports any shell command. For one-shot
commands (build, test) use
run_once in the ServiceWorker; for
long-running processes (npm dev server) use the Start button which
streams output live into the embedded console.
How do I report a bug or request a feature?
Open an issue on the GitHub repository:
github.com/devops-proj-manager/devops-proj-manager/issues