Ready made packages of Newscoop are available for Debian and Ubuntu GNU/Linux via secure apt. This is the recommended installation method for Newscoop, because it offers automatic updates and resolution of package dependencies. This guide assumes that you have sudo or root powers on the target server - if not, you need to ask your system administrator to install Newscoop for you.
To add the repository that contains the Newscoop software, open the sources.list file in the nano editor with:
sudo nano /etc/apt/sources.list
Type your password, and the sources.list file will open. For Ubuntu Lucid LTS, scroll to the end of this document and add the following line:
deb http://apt.sourcefabric.org/ lucid main
For Ubuntu Maverick, substitute maverick in place of lucid. For Debian Squeeze, substitute squeeze in place of lucid. Ubuntu natty and oneiric are also supported.
Press Ctrl+O to write out the sources.list file, and Ctrl-X to quit the nano editor.
You now need to update your sources. Type:
sudo apt-get update
You will probably see an error message about a missing public key. To fix this, you need to install the sourcefabric-keyring package, which contains the package signing key:
sudo apt-get install sourcefabric-keyring
Update your sources again, to confirm that you are now using a trusted software repository:
sudo apt-get update
You should no longer see the error message about the public key.
After confirming that the secure apt repository is set up, you can install the Newscoop package:
sudo apt-get install newscoop
This command will install all of the Newscoop components, plus any other packages that Newscoop requires in order to run. It will also upgrade a previous apt or .deb package Newscoop installation.
The package installer will ask you a few questions about the kind of server you want to set up, such as the Apache configuration that you require.
Optionally, install XCache for optimum Newscoop performance:
sudo apt-get install php5-xcache
Configuration options for XCache are covered in the Manual installation chapter.
Finally, check that Newscoop is running. Open a web browser with the URL of the web server that you have installed, such as http://www.example.com. For a test installation accessed from the same machine, this URL might be:
If you see the Newscoop installer page, and you do not wish to adjust the default XCache settings, you can now skip the chapter Manual installation and proceed to the chapter Installation steps.
If you see a page which says "It works! This is the default web page for this server. The web server software is running but no content has been added, yet" then you need to disable Apache's default site and reload the configuration, with the commands:
sudo a2dissite default sudo invoke-rc.d apache2 reload
Then refresh your browser.
If Apache complains about the domain name of the server, like this:
apache2: Could not reliably determine the server's fully qualified domain name, using 127.0.1.1 for ServerName
it probably means that you have no domain name configured for the server. For a test server on a local network, you may need to add an entry to the /etc/hosts file of the server, like this:
and a corresponding entry into the /etc/hosts file of your desktop machine on the network, like this:
where 192.168.1.2 is the IP address of your Newscoop server, and www.example.com is the name of your publication's website. For a server on a larger network or the public Internet, ask your network administrator for the correct domain names and IP addresses to use.
If you chose the 'System-wide (all vhosts)' option when installing Newscoop, and installation completed, but attempting to access the administration interface results in the error:
The requested URL /var/lib/newscoop/admin.php was not found on this server.
this means that you need to edit the file /var/lib/newscoop/.htaccess like so:
sudo nano /var/lib/newscoop/.htaccess
Add the line RewriteBase /newscoop under the line RewriteEngine On like this:
<IfModule mod_rewrite.c> RewriteEngine On RewriteBase /newscoop
Then save the file Ctrl+O, close nano with Ctrl+X, reload the Apache configuration:
sudo invoke-rc.d apache2 reloadand refresh your web browser.