Current

This document is valid for the current version of Plone.

Running Plone on Windows

by Mikko Ohtamaa last modified Mar 26, 2012 04:34 AM
This document explains how to start and run the latest Plone (Plone 4.1.4) on Windows 7. This document explains post-installer steps on how to start and enter into a Plone site.

Installation

This quick start has been tested on Windows 7. Installation remains the same on older versions of Windows through WinXP.

  1. Run installer from Plone.org download page
  2. The Plone buildout directory will be installed in C:\Plone41
  3. The installer will launch your Plone instance when it finishes. To connect, direct your browser to: http://127.0.0.1:8080

Note

In the buildout bin directory you'll find the executable files to control Plone instance.

For greater insight into the Windows installation process, Plone 4 Windows Installer Notes provides alternate deployment strategies for Windows.

Starting and Stopping Plone

If your Plone instance is shutdown you can start and control it from the command prompt.

Note

To control Plone you need to execute your command prompt as an administrator.

In the command prompt enter the following command to access your buildout directory:

cd "C:\\Plone41"

To start Plone in debug mode type:

bin\instance fg

You can interrupt the instance by pressing CTRL-C. This will also take down the Zope application server and your Plone site.

If you want to run Plone in production mode please follow instructions below and install the Plone Window background service:

bin\instance install

After this you can start Plone as a background service by typing:

bin\instance start

When started in this manner, to stop Plone:

bin\instance stop

Accessing Plone

When you launch Plone in debug or daemon mode it will take a few moments to launch. If you are in debug mode, Plone will be ready serve pages when the following line is displayed in your command prompt:

INFO Zope Ready to handle requests

When the instance is running and listing to port 8080, point your browser to address on your local computer:

http://127.0.0.1:8080

The Plone welcome screen will load and you can create your first Plone site directly by clicking the Create a new Plone Site button.

A form will load asking for the Path Identifier (aka the site id) and Title for a new Plone site. It will also allow you to select the main site language, and select any add-on products you wish to install with the site.

Note

These entries can all be modified once the site is created. Changing the site id is possible, but not recommended.

To create your site, fill in this form and click the Create Plone Site button. Plone will then create and load your site.

Note

The url of your local Plone instance will end with the site id you set when setting up your site. If the site id were Plone then the resultant URL is: http://127.0.0.1:8080/Plone.

Congratulations! You should be now logged in as an admin to your new Plone instance and you'll see the front page of Plone.


Contribute

Something wrong or out of date? Anybody can edit or create a new article in the knowledge base. Simply create an account on this site, log in, and click the Edit button to contribute.