Click once installer

Running on Windows

Forge is deployed using a click once installer. So it automatically updates to the newest version when you start the application. After installation of a new release, you will again receive automatic update notifications on application startup.

We moved Forge to a new deployment location. As a result existing installations of the previous DSTU-2 alpha release will no longer automatically detect the new update. Therefore we strongly advise you to uninstall the earlier DSTU-2 alpha release manually before installing this new version.

Running on Linux

Though .NET Core is available natively on Linux, the GUI framework, WPF is unfortunately not. However, it is possible to run Forge on Linux using Wine. While we do not officially support running Forge on Linux, here are the steps to get you started:

  1. Install Wine 2.4 (later versions have issues running .NET). If you’re using Ubuntu, copy/paste the following into the terminal:

    curl -O https://dl.winehq.org/wine-builds/ubuntu/pool/main/wine-staging-amd64_2.4.0-3~zesty_amd64.deb
    curl -O https://dl.winehq.org/wine-builds/ubuntu/pool/main/wine-staging-compat_2.4.0-3~zesty_amd64.deb
    curl -O https://dl.winehq.org/wine-builds/ubuntu/pool/main/wine-staging-compat_2.4.0-3~zesty_i386.deb
    curl -O https://dl.winehq.org/wine-builds/ubuntu/pool/main/wine-staging-dev_2.4.0-3~zesty_amd64.deb
    curl -O https://dl.winehq.org/wine-builds/ubuntu/pool/main/wine-staging_2.4.0-3~zesty_amd64.deb
    curl -O https://dl.winehq.org/wine-builds/ubuntu/pool/main/wine-staging_2.4.0-3~zesty_i386.deb
    curl -O https://dl.winehq.org/wine-builds/ubuntu/pool/main/winehq-staging_2.4.0-3~zesty_amd64.deb
    curl -O https://dl.winehq.org/wine-builds/ubuntu/pool/main/winehq-staging_2.4.0-3~zesty_i386.deb
    sudo dpkg -i *.deb
    
  2. Install winetricks:

    wget https://raw.githubusercontent.com/Winetricks/winetricks/master/src/winetricks
    chmod +x winetricks
    sudo mv winetricks /usr/local/bin
    
  3. Install .NET 4.6. Answer yes to installing Gecko and no to Mono:

    WINEPREFIX="$HOME/.forge7" WINEARCH=win32 winetricks -q dotnet46
    
  4. Download Forge.

  5. Run Forge with:

    WINEPREFIX="$HOME/.forge7" WINEARCH=win32 wine setup.exe
    

Forge will install and launch. To run Forge again the next time, repeat the command:

WINEPREFIX="$HOME/.forge7" WINEARCH=win32 wine setup.exe

Running on macOS

Though .NET Core is available natively on macOS, the GUI framework, WPF is unfortunately not. However, it is possible to run Forge on macOS using Wine. While we do not officially support running Forge on macOS, here are the steps to get you started:

  1. Install XCode from the App Store.

  2. Open the terminal:

    Open Launchpad, then type “Terminal” into the search field.
    
  3. Install Homebrew by copy/pasting the following into the Terminal:

    /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
    
  4. Install XQuartz. This is a prerequisite for Wine. This may take some time:

    brew doctor
    brew cask install xquartz
    
  5. Install Wine itself. This may take some time:

    brew install wine
    
  6. Setup Wine to run .NET 4.6 applications, which is what Forge is built with:

    test "$?BASH_VERSION" = "0" || eval 'setenv() { export "$1=$2"; }';                setenv PATH "/Applications/Wine Stable.app/Contents/Resources/start/bin:/Applications/Wine Stable.app/Contents/Resources/wine/bin:$PATH"; winehelp --clear
    curl -O https://raw.githubusercontent.com/Winetricks/winetricks/master/src/winetricks
    chmod +x winetricks
    WINEPREFIX="$HOME/.forge" WINEARCH=win32 ./winetricks -q dotnet46
    
  7. Download setup.exe from the Forge download page and run it:

    WINEPREFIX="$HOME/.forge" WINEARCH=win32 wine $HOME/Downloads/setup.exe
    

That’s all - Forge will now install and run, should it all went successfully.

To run Forge again in the future, run the following in the terminal:

test "$?BASH_VERSION" = "0" || eval 'setenv() { export "$1=$2"; }';                setenv PATH "/Applications/Wine Stable.app/Contents/Resources/start/bin:/Applications/Wine Stable.app/Contents/Resources/wine/bin:$PATH"; winehelp --clear
WINEPREFIX="$HOME/.forge" WINEARCH=win32 wine $HOME/Downloads/setup.exe