In defailt mode, this is intended to demonstrate issues with the MAUI Gtk platform and not for active development as changes in the container would get lost on a docker build. But there is a devcontainer setup to have the maui folder mounted as a docker volume to persist changes to the codebase (see "Optional Setup with Persistent Volume Share on Local Host" section in the Dockerfile).

• Docker or Podman

You can choose to use github packages or use the source.

# Pull Docker package
docker pull ghcr.io/MauiGtk/maui-docker:main

# Build Docker environment
xhost +  # allow container to use the X display of the host
# replace the 'dotnet ...' command with 'bash' to have a look inside the container:
docker run -it --rm -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix -t ghcr.io/mauigtk/maui-docker:main dotnet run --framework net8.0-gtk
xhost -  # restrict display access again

# git clone
git clone https://github.com/MauiGtk/maui-docker.git
cd maui-docker

# Build Docker package
docker build -t maui-env .

# Build Docker environment
xhost +  # allow container to use the X display of the host
# replace the 'dotnet ...' command with 'bash' to have a look inside the container:
docker run -it --rm -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix -t maui-env dotnet run --framework net8.0-gtk
xhost -  # restrict display access again

Alternatively, use Visual Studio Code to handle the display and have a deeper look at the MAUI sources:

1. Start VS Code in a new bash outside the container with code .,
2. then install VS Codes 'Dev Containers' and 'Docker' extension. After that,
3. in the 'Containers' item of side panel start the 'maui-env' container and right click / attach it to VS Code,
4. then click the generated container name at the top.
5. In the newly opened Code window, wait a few seconds until VS Code is setup in the container.

Finally open folder /mauienv/maui/ and enter these commands in VS Codes terminal window:

cd /mauienv/maui/src/Controls/samples/Controls.Sample
dotnet run --framework net8.0-gtk

... or simply hit Ctrl + Shift + D and launch the sample by pressing the play button.

Also have a look at

cd ../Controls.Sample.Gtk
cp ../Controls.Sample/Resources/Images/calculator.png ./dotnet_bot.png  # someone forgot to git add the image
dotnet run