Skip to content

Conversation

@ibi420
Copy link
Contributor

@ibi420 ibi420 commented Sep 24, 2025

Description

This PR updates the Linux/Kali VM/Docker setup documentation for Doubtfire.
It provides step-by-step instructions for building and running Doubtfire in a virtualised Linux environment, including Docker installation, repository setup, VS Code Dev Container usage, troubleshooting, and performance optimisation.
The guide also covers switching between development and 9.x branches, handling common issues (such as Ruby version mismatches and database migration errors), and recommendations for VM resource allocation.

Fixes # (issue)

Type of change

  • Documentation (update or new)

How Has This Been Tested?

The instructions were followed in a Kali Linux VM with Docker and VS Code.
Builds for both development and 9.x branches were tested, including troubleshooting steps for Ruby version mismatches and database resets.
Performance was evaluated by adjusting VM resources.

Testing Checklist

  • Tested in latest Chrome
  • Tested in latest Firefox

Checklist

  • My changes follow the style guidelines of this project
  • I have performed a self-review of my own code
  • I have made corresponding changes to the documentation
  • My changes generate no new warnings

@netlify
Copy link

netlify bot commented Sep 24, 2025

Deploy Preview for ontrackdocumentation ready!

Name Link
🔨 Latest commit 9bdc2dd
🔍 Latest deploy log https://app.netlify.com/projects/ontrackdocumentation/deploys/68d38ef2a8881b0009e7bb8f
😎 Deploy Preview https://deploy-preview-60--ontrackdocumentation.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link

@AB-Deakin AB-Deakin left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed and approved by Alex Brown 24/09/2025.

Copy link
Contributor

@theiris6 theiris6 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice work approved!

Copy link

@MillicentAmolo MillicentAmolo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The troubleshooting section is very practical for solving issues, otherwise the documentation is clear and easy to follow. Nice work.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants