# Running Grima on your Desktop

If you use Windows at work, or Mac OS anywhere, and you can install software on
your computer, than you can run grima on your own computer.

Grima requires a web-server, but [Docker
Desktop](https://docs.docker.com/docker-for-windows/install/) (and [for
MacOS](https://docs.docker.com/docker-for-mac/install/)) run a web-server on
its own private internet inside your computer.

If your IT people aren't comfortable having you install docker on your
computer, then you can use the [public grima](https://public-grima.zemkat.org)
while you ask them to install an institutional copy of the [grima
server](SERVER.md).

You'll need an [Alma API Key](APIKEY.md) to use grima, though you can see some
of what it can do at the [grima sandbox](https://grima-sandbox.zemkat.org) or
by looking over some of [Kathryn's
presentations](https://works.bepress.com/kathrynlybarger/).

Once you install Docker, installing grima is pretty easy. It is a short file
(you can read it yourself) that downloads the latest copy of the grima
web-server, stops any currently running grima web-server, and starts the
new-one.

If you use Windows, use
[grima-desktop.bat](../containers/desktop/grima-desktop.bat) (or [direct github
link](https://raw.githubusercontent.com/zemkat/grima/master/containers/desktop/grima-desktop.bat)).
Save the file, then open it. Click ok on the "Don't run untrusted software."

XXX: Screenshots

For Mac OS, use [grima-desktop.sh](../containers/desktop/grima-desktop.sh) (or
[direct github
link](https://raw.githubusercontent.com/zemkat/grima/master/containers/desktop/grima-desktop.bat)).

XXX: Can you just double click it? Is it worth make an applescript app?