Install eZ publish 3 using installers

• Install eZ publish 3 using installers
• Windows installer
• Linux installer
• FreeBSD installer

You have basically four ways of installing eZ publish 3. You can use one of the supplied installer packages, which will install Apache, PHP, MySQL, ImageMagick and set up everything needed to get eZ publish up and running. Another option is to use the publish sources and follow the setup wizard which will guide you through the steps of configuring your system for eZ publish. If you are little more experienced you can disable the setup wizard and configure eZ publish 3 from scratch following the installation manual. If you don't want to install eZ publish 3 yourself you can always hire eZ systems to install the software for you. You can also buy a ready hosted eZ publish 3 solution.

The installers are meant as a quick way to get eZ publish up and running for testing purposes. If you plan on using eZ publish for more than just testing, we recommend you to install it manually either by letting the setup guide do the configuration or by configure eZ publish by hand.

Install eZ publish 3 using installers

With the installers you get the basic requirements you need to run eZ publish 3 on your platform. You will get Apache, PHP, MySQL and ImageMagick. If you don't want these requirements we recommend that you do not use the installers. Then you should install eZ publish 3 without the installers.

Windows installer

1. Go to http://ez.no/download
2. Find the Windows installer matching your Windows version
3. Download the installer to your hard drive
4. Double click on the downloaded file and follow the instructions*
5. Now the installation will start. This can take a few minutes
6. When the installation is done you need to start eZ publish by clicking on the eZ publish icon on the desktop. This will open eZ publish in your default browser. eZ publish will open at the User site. To start the Admin site simply write /admin after the rest in the URL. Log in with admin and publish.
7. You are ready to start using eZ publish.

*Choose demo data in the installation if you want to use that as an example on how to use eZ publish.

Note: If you have anything listening on the same port as Apache (80) or as MySQL (3306) you need to shut those services down because Apache and MySQL won't start if port 80 or 3306 is in use.

Linux installer

1. Open your web browser and go to http://ez.no/download
2. Find the Linux installer matching your distribution. These installers are tested on Linux Redhat, but might as well work fine on other distributions.
3. Become root by running

    $ su - 

Note: it is important that you run "su -", and not "su". The installer needs to have system variables for the root user

4. Unpack the downloaded file

    # tar xvfz ezpublish-3.0-xxx-x-Linux-xxx.i386.tar.gz

   Replace ezpublish-3.0-xxx-x-Linux-xxx.i386.tar.gz with your current version.
5. Enter the extracted directory

    # cd ezpublish-3.0-xxx-x-Linux-xxx.i386 

6. Run the installation program

    # ./install.sh

7. Choose "install eZ publish" and press Enter
8. If you only have one network card press enter on the question on "What is your internal network card". If you have more than one card enter the name of the network device connected to your network.
9. Enter port number for the user demo site, press enter for default port (1337)
10. Enter port number for the admin site, press enter for default port (1338). Check of [x] for installation of demo data. If not you will get a clean setup. Clean setup is useful when starting to develop a new site. The demo data is useful for testing out the system.
11. You will get a report of what's installed.
12. "OK" to quit

Installation of eZ publish 3 is now done. You can access the demo site at: http://localhost:1337 and the default admin site at http://localhost:1338

FreeBSD installer

1. Open your web browser and go to http://ez.no/download
2. Find the FreeBSD installer. This installer is tested on FreeBSD 4.6.2, but should work on other versions of FreeBSD as well.
3. Become root by running:

    $ su - 

   Note: it is important that you run "su -", and not "su". The installer needs to have system variables for the root user.

4. Unpack the downloaded file

    # tar xvfz ezpublish-3.0-xxx-x-FreeBSD-STABLE.i386.tar.gz

   Replace ezpublish-3.0-xxx-x-FreeBSD-STABLE.i386.tar.gz with your current version.
5. Enter the extracted directory

    # cd ezpublish-3.0-xxx-x-FreeBSD-STABLE.i386

6. Run the installation program:

    # ./install.sh

   Note:The FreeBSD Installer requires bash to be located under /usr/local/bin. If you do not have bash installed please refer to the FreeBSD Handbook for more help on installing bash.

7. Choose "install eZ publish 3" and press Enter
8. Enter the device name of your network card. You can find the name of your network card by running "ldconfig".
9. Enter port number for the user demo site, press enter for default port (1337).
10. Enter port number for the admin site, press enter for default port (1338). Check of [x] for installation of demo data. If not you will get a clean setup. Clean setup is useful when starting to develop a new site. The demo data is useful for testing out the system.
11. You will get a report of what's installed.
12. "OK" to quit

Installation of eZ publish 3 is now done. You can access the demo site at: http://localhost:1337 and the default admin site at http://localhost:1338