This is a guide for installing Art Menagerie.

This guide assumes you have already downloaded Art Menagerie from the Download page.

Check out the Getting Started guide.

Mac / Linux / BSD

Open the Terminal.app that comes with Mac or other terminal software to get a command-line.

Then do the following on the command-line:

1. Make a directory for Art Menagerie
2. Change directories to the new directory
3. Extract the .tar.gz file you downloaded

Example:

mkdir -p ~/artmenagerie
cd ~/artmenagerie
tar -xzvf ~/Downloads/artmenagerie-VERSION.tar.gz

Some things to note:

• VERSION should be replaced with the version you downloaded
• The example assumes you downloaded the file to the ~/Downloads directory
• You can start typing ~/Downloads/artmenagerie and press the TAB key to complete it without typing the whole filename yourself

You should now be able to run Art Menagerie like so:

./artmenagerie

Note: If you followed the example, you will need to run cd ~/artmenagerie when you open your terminal again to run ./artmenagerie again.

If you are on Mac and you receive a warning about running software you downloaded from the internet, you can clear this warning by running:

xattr -cr artmenagerie

Then try running ./artmenagerie again. This should not necessary for Linux or BSD operating systems.

If successful, you will see this appear in the terminal:

DATE TIME INFO Running web server... url=http://127.0.0.1:4747/admin/

You can now visit http://127.0.0.1:4747/admin/ in your web browser to access the admin UI.

Windows

I do not have a Windows machine. I would appreciate it if someone with a Windows machine tests the install process and helps with instructions.

From Source Code

You can build from source by following instructions in the README