Download & install the necessary software
Installing MAMP
Download MAMP from their site: https://www.mamp.info/en/downloads/
Choose the appropriate version if you're running an Intel processor or Apple Silicon.
Run the installation program. This will install MAMP and a demo version of MAMP Pro. Ianseo
only needs the functionality in MAMP so you do not need to purchase MAMP Pro unless you wantto.
After the installation, you will nd a folder called MAMP in the Applications folder. Open this folder
by double clicking on it and then start the MAMP application.

Most of the standard values are su cient for Ianseo, but a couple of adjustments need to be done
rst. Choose Preferences and then the Ports tab. Click the button “80 & 3306” to set MAMP tothe default ports for web and MySQL.

Installing Ianseo

fi

fi

ffi

To install the Ianseo software, download the installation les which can be found athttps://www.ianseo.net/Releases.php in the zip le for Linux/Mac

fi

fi

Installing Ianseo on MacOS with MAMP

Setting up the system
For the purpose of the guide Ianseo will be installed in its own folder, called ianseo.
1. Open folder “/Applications/MAMP/htdocs”
2. Create a folder inside it and name it “ianseo” (all lower case, without quotes)
3. Uncompress the contents of the downloaded zip le inside the ianseo folder
4. IMPORTANT: Open the folder “/Applications/MAMP/htdocs/ianseo/Common” anddelete the le config.inc.php (if it exists) to allow the installation procedure to start.
5. Open a terminal window (Applications -> Utilities -> Terminal)
6. Go to the MAMP folder by type the command below, including a space between cd and /, andpress Enter:
cd /Applications/MAMP/htdocs
7. Type the following command and press Enter. You will be asked the password of your user:
enter it but remember that nothing will be displayed while typing, not even *.
sudo chown -R nobody:admin ianseo
8. Type the following command and press Enter (again it can ask for the password):sudo chmod -R 777 ianseo

Running Ianseo
Start the MAMP application and then press the Start button. This will start the Apache web server
and the MySQL database. You may be prompted to enter your password; enter it to continue.

fifiOnce MAMP starts, your browser should automatically open to a Welcome to MAMP page
showing the current version number.

fiIf this is a new installation, follow the onscreen instructions. WARNING: During installation, MAMP
does not set the MySQL root password, so when the installer will ask for it, leave it blank. The
other elds can be left with default values. Click the Create user and database button toproceed. Note: If the installation program displays an error message indicating that it could notconnect to the database, enter “root” in the ADMIN Password to create users and databases
elds and click the Create user and database button to try again.

fifi

To start Ianseo, enter the address http://localhost/ianseo in a new tab. You will rst need to agree
to the GPL3 License Agreement. Check the box and click on the I AGREE button. Once that isdone, you should see a screen similar to the one below showing that the software is installed
correctly. Click Continue to proceed.

Once the database information is con gured, you should see the message below. Ianseo is now
installed on your system.

Click on the link “Go to IANSEO!” to update your system to the latest version. This willautomatically download the latest version of the software and update the language les. When
this is nished you will see the message “The upgrade process is nished.”. Click the button tocontinue.

fi

fi

fi

fi

You should now see the screen below. Ianseo is now fully installed and ready to be used!