DDEV Test Environment for OpenMage with a Proxy Connection

[addison74]

Last update: February 27, 2025

For run a DDEV Test Environment in Windows 10/11 please visit this link #4656. This post is an addendum for a particular case. Although there is information on the Internet, unfortunately not all situations that may arise are taken into account.

When you connect to the Internet through a proxy connection, with or without authentication, because the network administrator has banned the access to certain websites (YouTube, Facebook, TikTok), you have to make some changes to be able to run properly the DDEV-based test environment.

Configuring the proxy connection in the operating system

In Windows 10 or 11, click the Start button, type the word "proxy" and from the list click on "Proxy settings". In the Proxy window configure the following options

• Use proxy server
• Address and Port
• URLs that do not use a proxy connection. In my case the DDEV test environment is local and I access it in the browser by entering the address openmage.ddev.site.

Running Git in Windows

If you have installed Git on Windows then you need to configure it for a proxy connection. Some programs can read the .gitconfig configuration file. This is located in the C:\Users{User_Name} directory. Edit it and at the end add the following lines

[http]
	proxy = http[s]://username:password@IP_ADDRESS:PORT_NUMBER

Some programs like GitHub Desktop don't work with a proxy configuration, it's a known issue. I have seen authentication issues when adding a GitHub account to Sourcetree. Other programs may use the .gitconf file in the C:\Program Files\Git\etc directory, my recommendation is if you are experiencing connection problems to contact the developers.

Configuring the proxy connection inside the WSL

To update the Ubuntu/Debian distribution packages, you have to create the following file with administrator rights /etc/apt/apt.conf.d/80proxy.conf. Save the file then run the command sudo apt update for checking the connection.

The git command reads the configuration stored in this file /home/{User_Name}/.gitconfig. Edit it and at the end add the following lines

[http]
	proxy = http[s]://username:password@IP_ADDRESS:PORT_NUMBER

To check if the proxy connection is working, clone a GitHub repository into a directory inside the WSL.

Now edit the file /home/{User_Name}/.bashrc and at the end add the following lines

export http_proxy="http://username:password@IP_ADDRESS:PORT_NUMBER"
export https_proxy="http://username:password@IP_ADDRESS:PORT_NUMBER"
export ftp_proxy="ftp://username:password@IP_ADDRESS:PORT_NUMBER"
export no_proxy=""

export HTTP_PROXY="http://username:password@IP_ADDRESS:PORT_NUMBER"
export HTTPS_PROXY="http://username:password@IP_ADDRESS:PORT_NUMBER"
export FTP_PROXY="ftp://username:password@IP_ADDRESS:PORT_NUMBER"
export NO_PROXY=""

After saving run the command . .bashrc to load the changes without restarting.

Configuring the PhpStorm IDE

Go to the menu File > Settings... In the Settings window, go to Appearance & Behavior > System Settings > HTTP Proxy and configure the following options

• Manual proxy configuration
• HTTP
• Host name
• Port number
• No proxy for
• Proxy authentication (Login, Password, Remember)

After you have configured it, click the [Check connection] button and if there are no errors then close the window by clicking the [OK] button. Updating the local repository with the remote should now be done without any issues.