2354
Views
21
Comments
Outsystems Development Environment on Linux (Ubuntu)

I am using Linux (actual Ubuntu Version) on my private Workstation, so I tried to get Outsystems Development Environment running on Linux. My first Try was to use Wine or Play on Linux, but ended up with missing .NET Dependencies, which I couldn't fix.

Second Try was successful for me (see attached Screenshot), so I want to share that with you:

1) Installing VirtualBox from the Ubuntu Software Catalog

2) Downloading and Importing Windows VM (Windows 11 Enterprise with Visual Studio 2022)
https://developer.microsoft.com/de-de/windows/downloads/virtual-machines/

3) Downloading and Installing the Outsystems Development Environment in that Virtual Windows Machine
(including Service Studio and Integration Studio)

That's it, the only "disadvantage" is that the Download of the VM is about 20 GB and is only valid for 30 days. But the positive thing is that you have Visual Studio in the actual Version included.

So please let me know if this works for other Linux Users too


Outsystems_VirtualBox_Windows11.png
UserImage.jpg
Hercules SantAna da Silva Jose

Hello Thomas.

A few weeks ago I tried to run the OutSystems environment on Linux using Wine. However I did not have much success and chose to use a Windows VM to run the environment.

In addition to the Windows Enterprise VM, you can also create a Windows 10 VM in Microsoft Azure. Unfortunately the credits offered to test the services expires in 30 days. 

I didn't get a chance to test OutSystems on Mac. I think the Mac version does not support traditional WebApp development.

Best regards.

2022-04-27 23-29-16
andrehigashimonteiro

Hi Hercules, I'm new here at Outsystems, but I already have some experience in Linux and I've been studying a library translation tool called "Wine" for Linux. When I started training with "RafaOutsystems" I had the same problem running the Service Studio on Linux. Because of that, I started testing with the "Lutris" tool, which is a graphical program that runs Wine in graphical mode to make configuration easier.


luckily I've had good results with Wine using the "Lutris" program developed to run MS Windows games on Linux running wine underneath. It is nothing more than a facilitator for Wine to run games, although it was created exclusively to run games, precisely because it runs these complex software that I thought of using it to run the "Service Studio" from "Outsystems". I had good results but I'm still doing more tests to confirm if there will be more problems or other bugs. I will bring more results in the future.


 Currently Using Xubuntu 22.04 LTS.


2022-10-20 11-53-07
Thomas Beck

Hello André, thank you for your reply on that Topic.

interesting to see that you could get it run with Wine (which I couldn't because of missing .NET Dependencies) and Lutris (which I never heard of before, but I am not a Gamer...).

It would be nice if we could bring it to something like "Recommendations for Linux Users" as long as Development Environment is not officially packaged for Linux.

2022-04-27 23-29-16
andrehigashimonteiro

Hi Thomas, how are you?

Thank you for your interest because I'm a Linux user and I've been using it for over 10 years, I still don't know everything about the system but I can work with it normally in my day-to-day. I play with him, work, etc. Surely what you commented on using the Outsystems environment for Linux, I consider it a reality, with some adjustments it is possible for you to run Outsystems on Linux.

But it takes a little time and patience to succeed with this process. I'm still testing the platform under Linux. It is necessary to point out that using Wine in my case with Lutris, the platform will run as if it were native, that is, Wine is a layer that translates MS Windows libraries into Linux binaries. So speaking more clearly it runs without any impediment in terms of speed performance or something, this will only happen if your machine is not able to run Outsystems in normal situations as if it were inside Windows.

2022-04-27 23-29-16
andrehigashimonteiro

Another thing I forgot to mention was that when you run the Outsystems software and complain about the .NetFramework it will be exactly the same as if you were inside Windows, that is, you will have to install the framework inside Wine to successfully run Outsystems because this software is missing. In this case you will have to go to Winetricks which is another software with a graphical interface for better configuration and installation of Wine/Windows libraries so that any MS Windows program that you want to run under Linux is successful.

2023-10-18 19-55-47
Dawud M.

Hi André. It would be great if you could write a step-by-step tutorial on how to get this configured. :)

2022-04-27 23-29-16
andrehigashimonteiro

Good morning, good afternoon and good night guys.


I've been bringing more news about how Outsystems works on Linux. Yesterday I started to do the Digital Alchimia training again from RafaOutsystems here in Brazil.


And I managed to create the first application of the training with Outsystems inside Linux. I was successful, at some point due to some inconsistency in Wine Service Studio unexpectedly closed, but I managed to reverse the situation by changing the version of Wine within Lutris. I continued until the end of the class with success in the Outsystems application. Then I posted some prints of what I managed to do yesterday.

UserImage.jpg
Hercules SantAna da Silva Jose

Hi Andre. 

Have you written any tutorial on how to install Service Studio using Lutris?

UserImage.jpg
Ronaldo Marques

Great @André, thanks for share.

@Hercules , lets try do it. The instalation, using, so writing some tutorial.


At.

Ronaldo.

UserImage.jpg
Jagdeep Kumar Mahto

explain  more details

2020-12-26 13-55-52
Eloi Carlos Santaroza

I managed to do it using bottles, I thought it was pretty easy, if you want I'll put a step by step. But basically it's creating a bottle with a dependency on dotnet 4.6.1 and running it, ignoring some errors that can occur and then the service studio opens.


https://usebottles.com/

Bottles Linux


2023-10-18 19-55-47
Dawud M.

Hi Eloi. It would be great if you could write a step-by-step tutorial on how to get this configured. :)

2022-08-12 09-46-04
Andrew Bowen

I created a new app with Bottles, and when I add the .NET 4.6.1 dependency, it fails to install with 


"Setup may not run properly, because the Windows Modules Installer Service is not available on this computer."

Did you resolve this properly or just press "Continue"?

Pressing Continue, the installer seems to finish, it opens up my default web browser with the Trial Portal and the desktop application crashes



I've installed

- core fonts

- .NET 4.6.1 (as per here)

- .NET 4.8

- .NET Core 3.1 LTS

- .NET Core 6.0 LTS

2022-08-12 09-46-04
Andrew Bowen


https://www.outsystems.com/forums/discussion/72866/outsystems-11-working-on-arch-linux/

2020-12-26 13-55-52
Eloi Carlos Santaroza

Install prerequisites

sudo apt update

sudo apt install -y flatpak gnome-software-plugin-flatpak

flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

Install and open Bottles

flatpak install -y flathub com.usebottles.bottles

flatpak run com.usebottles.bottles

Create the bottle


  1. Bottles → Create New Bottle.
  2. Name: outsystems-ss.
  3. Environment: Application.
  4. Runner: default (Soda).
  5. Create.



Install Windows dependencies (GUI)


  1. Open bottle outsystems-ss.
  2. Dependencies (Installers) → install: .NET Framework 4.8, Visual C++ Redistributable 2015–2022.
  3. If fonts are missing later, install Microsoft Core Fonts (if listed).



Install Core Fonts (CLI alternative)

flatpak run --command=bash com.usebottles.bottles

bottles-cli shell -b outsystems-ss

winetricks corefonts

exit

exit

Download Service Studio


  1. Download the OutSystems Service Studio 11 .exe installer.



Install Service Studio


  1. Bottles → bottle outsystems-ss → Run Executable.
  2. Select the Service Studio .exe → Next → Finish.



First run


  1. Bottles → bottle outsystems-ss → Programs → Service Studio.
  2. Log in to your OutSystems environment.



If UI issues


  1. Bottle outsystems-ss → Settings → Components → disable DXVK.
  2. Bottle outsystems-ss → Settings → change Runner if needed.




 Replying to Dawud M.'s comment on 16 Oct 2023 20:16:23


2018-05-13 14-46-27
Samuel Caeiro

Since i bought a steam deck that i've been trying to run Service Studio on Linux.
I've had success with some attempts but i feel the best way is using bottles and messing around with the runners inside bottles

2022-03-10 08-26-10
Cristian Angel Puma Villalva

Hello everyone,

I wanted to know if you can now run Outsystems Service Studio on Ubuntu.


Greetings from Peru.

2022-08-12 09-46-04
Andrew Bowen

Three ways to run it that I'm aware of

- Bottles: I've left a comment here with process & issues https://www.outsystems.com/forums/discussion/72866/outsystems-11-working-on-arch-linux/#Post413554

- WinApps: Runs Windows in VM but integrates it seamlessly into Linux desktop https://github.com/winapps-org/winapps

- Virtual Machine: Follow whatever process you want but I use Tiny11 to avoid bloatware Microsoft adds. Use Docker or whatever VM tool you're comfortable with


I had graphical glitches with Bottles & WinApps, so now I just run it in a VM. 

2022-08-12 09-46-04
Andrew Bowen

Decided to trial running it in Bottles again with 11.55.33.64295

Installed as many dependencies as could (allfonts, NET48, Core3/6/8) and getting following errors during Install

```

017c:err:module:fixup_imports_ilonly mscoree.dll not found, IL-only binary L"System.Runtime.dll" cannot be loaded
017c:err:module:fixup_imports_ilonly mscoree.dll not found, IL-only binary L"System.Runtime.dll" cannot be loaded
017c:err:eventlog:ReportEventW L"Application: OutSystemsUpdater.exe\n"
017c:err:eventlog:ReportEventW L"CoreCLR Version: 8.0.524.21615\n"
017c:err:eventlog:ReportEventW L".NET Version: 8.0.5\n"
017c:err:eventlog:ReportEventW L"Description: The process was terminated due to an unhandled exception.\n"
017c:err:eventlog:ReportEventW L"Exception Info: System.IO.FileNotFoundException: Could not load file or assembly 'C:\\Program Files\\OutSystems\\Service Studio 11\\Service Studio\\OutSystemsUpdater\\System.Runtime.dll'. Mo
dule not found.\r\n"
017c:err:eventlog:ReportEventW L"File name: 'C:\\Program Files\\OutSystems\\Service Studio 11\\Service Studio\\OutSystemsUpdater\\System.Runtime.dll'\n"
wine: Unhandled exception 0xe0434352 in thread 17c at address 00006FFFFFC53D47 (thread 017c), starting debugger...
0168:err:seh:KiUserCallbackDispatcher ignoring exception

```

I browsed local files and see it here

/home/myUser/.local/share/bottles/bottles/outsystems-ss/drive_c/Program Files/OutSystems/Service Studio 11/Service Studio/OutSystemsUpdater/


Anyone had this and resolved?


Edit: Found this https://github.com/bottlesdevs/Bottles/issues/2887#issuecomment-2646141675

Make sure you use Custom Bottle, not Application. 

i.e. You don't want Wine Mono installed otherwise .NET 4.8 won't install properly

2020-12-26 13-55-52
Eloi Carlos Santaroza

You’re hitting the classic Wine-Mono vs. .NET 4.8 conflict. Do this clean sequence (works with 11.55.33.64295):


1) Create a clean Custom bottle (no Mono)


  1. Bottles → Create New Bottle → Custom.
  2. Name: outsystems-ss.
  3. Uncheck/decline any prompts to install Mono/Gecko.
  4. After creation: Bottle → Settings → Runner = default (Soda) and Windows version = Windows 10/11.



2) Remove Mono if it slipped in

flatpak run --command=bash com.usebottles.bottles

bottles-cli shell -b outsystems-ss

winetricks remove_mono

exit

exit

3) Install dependencies (in this order)

Bottle outsystems-ss → Dependencies:


  • .NET Framework 4.8 (or 4.8.1 if available)
  • Visual C++ Redistributable 2015–2022 (x86 and x64)
  • .NET Desktop Runtime 8 (x86) (not just “Core”)
  • .NET Desktop Runtime 6 (x86) (optional but helps some plugins)
  • Microsoft Core Fonts (or corefonts via winetricks if you don’t see it)



If you don’t see Core Fonts in the GUI:

flatpak run --command=bash com.usebottles.bottles

bottles-cli shell -b outsystems-ss

winetricks corefonts

exit

exit

4) Ensure DLL override for mscoree

Bottle → Settings → DLL Overrides:


  • Add mscoree → set to native, builtin.



5) Install Service Studio

Bottle → Run Executable → pick the Service Studio 11.55.33.64295 installer → finish.


6) First run (bypass updater if it still crashes)


  • Try launching normally: Bottle → Programs → Service Studio.
  • If OutSystemsUpdater.exe still throws the mscoree.dll/System.Runtime.dll errors:
    1. In the bottle’s file manager, go to
      drive_c/Program Files/OutSystems/Service Studio 11/Service Studio/OutSystemsUpdater/
      and rename OutSystemsUpdater.exe to OutSystemsUpdater.exe.bak.
    2. Launch ServiceStudio.exe directly from Service Studio folder.
    3. Disable auto-update inside Service Studio if prompted; do manual updates later.



7) Graphics fallback if you get a blank window

Bottle → Settings → Components → Disable DXVK (use wined3d/OpenGL) and retry.

If needed, switch Runner version.


This sequence fixes the mscoree binding so IL-only assemblies load under real .NET 4.8, and adds the required .NET 8 Desktop runtime that the updater expects.


UserImage.jpg
Vikram Navale

Apologies for necro-bumping, but a solution that worked for me (Ubuntu 24.04 on Framework 16) is to add the installer to my Steam library as a non-Steam application and set the latest stable Proton version as the compatibility layer (right-click -> Properties).

Community GuidelinesBe kind and respectful, give credit to the original source of content, and search for duplicates before posting.