https://github.com/pauleve/docker-mtgo
Docker image with ready-to-play MTGO (Magic Online) for Linux and macOS
https://github.com/pauleve/docker-mtgo
cards docker-image game linux magic-the-gathering
Last synced: 2 months ago
JSON representation
Docker image with ready-to-play MTGO (Magic Online) for Linux and macOS
- Host: GitHub
- URL: https://github.com/pauleve/docker-mtgo
- Owner: pauleve
- Created: 2017-08-13T18:17:14.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2025-07-12T12:30:05.000Z (3 months ago)
- Last Synced: 2025-07-12T14:46:57.323Z (3 months ago)
- Topics: cards, docker-image, game, linux, magic-the-gathering
- Language: Shell
- Homepage: https://hub.docker.com/r/panard/mtgo/
- Size: 755 KB
- Stars: 520
- Watchers: 15
- Forks: 34
- Open Issues: 31
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
# MTGO docker image
> :warning: :warning:
> **With the recent transition to Daybreak, you need to perform once**
> ```
> ./run-mtgo --reset --update
> ```
>
This image provides a ready-to-play Magic The Gathering Online (MTGO) for Linux
and macOS.
Join the "WineHQ Players" clan! (Account > Buddies, Clan, Chat > Look for WineHQ Players and contact the captain, or send a mail to panard at inzenet dot org with your MTGO user name)
It is based on an amd64 [debian:stable-slim](https://hub.docker.com/r/_/debian/) Linux distribution and [WineHQ](https://www.winehq.org/) with WOW64 support.
See https://appdb.winehq.org/objectManager.php?sClass=version&iId=32007 for more information.
You can buy me a beer using either
- Github [](https://github.com/sponsors/pauleve)
- Paypal [](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=Y27XTWGY3ZZFY)
## Installation
A necessary prerequisite is to install **docker**: https://www.docker.com/community-edition#/download.
You do _not_ need wine.
### Linux
Open a terminal and install the `run-mtgo` script:
```
wget -O run-mtgo https://raw.githubusercontent.com/pauleve/docker-mtgo/master/run-mtgo
chmod +x run-mtgo
```
Make sure your user is in the `docker` group (command `groups`). If not, add yourself to the docker group:
```
sudo usermod -aG docker $USER
```
You need to logout/login for the changes to take effect.
### macOS
Support for macOS is still under test.
Using [Homebrew](https://brew.sh/), install XQuartz, socat, and the GNU version of getopt.
```
brew install xquartz
brew install socat
brew install gnu-getopt
brew install wget
```
Then **restart your session** (or reboot) and, install the `run-mtgo` script:
```
curl -o run-mtgo https://raw.githubusercontent.com/pauleve/docker-mtgo/master/run-mtgo
chmod +x run-mtgo
```
*Important for macOS users*: depending on your configuration the Docker image may not work properly. You can consider installing MTGO using Wine directly, following the instructions here: https://github.com/pauleve/docker-mtgo/wiki/macOS:-installing-MTGO-using-Wine
## Usage
Run the docker image using the [run-mtgo](./run-mtgo?raw=true) helper script
```
./run-mtgo
```
Depending on your configuration, you may want to adjust the resolution of the game, or even switch to desktop emulation which may fix some graphics issues.
```
./run-mtgo --winecfg
```
It will launch a configuration tool prior to launching MTGO. There you may be interested in the Graphics tab and use settings like this:
Sound is disabled by default, but adventurous users can give a try to
```
./run-mtgo --sound
```
do not hesitate to report issues.
To ensure running the latest docker image, use
```
./run-mtgo --update
```
You shoud consider updating the `run-mtgo` script as well by following the
installation procedure.
See
```
./run-mtgo --help
```
for other options.
## Troubleshooting
* `run-mtgo` prompt for .NET installation:
```
./run-mtgo --reset # only once
```
* `run-mtgo` got permission denied while trying to connect to the Docker daemon socket:
Add yourself to the docker group:
```
sudo usermod -aG docker $USER
```
You need to logout/login for the changes to take effect.
* `run-mtgo` never exits, even after Ctrl+C:
```
docker kill mtgo_running
```
## FAQ
* [Change game resolution](https://github.com/pauleve/docker-mtgo/issues/12#issuecomment-355844711)
### Import/export deck files
By default, the folder `~/.local/share/mtgo/files` is bound to the Windows "Documents" folder.
You can change it using the `--bind` option: assuming your decks are in the `~/mtgo` folder
```
./run-mtgo --bind ~/mtgo
```
to have access to this folder from the Docker mtgo as the `Documents` folder.
See also [Access host files](https://github.com/pauleve/docker-mtgo/issues/11#issuecomment-355766306)
### Replace Docker with Podman
If you are using podman as an alternative container manager, change the value of the "docker_client" parameter to podman. Also add the "--userns keepid" to the "opts" parameter, since default Podman behavior doesn't change file ownership when mounting a volume.