Commit ff9907cc authored by Laurent Peuch's avatar Laurent Peuch
Browse files

[doc] how to install pyramid or twisted application server

branch : 3.26
parent addfdabaa35f
......@@ -64,6 +64,12 @@ Update your list of packages and perform the installation::
apt-get update
apt-get install cubicweb cubicweb-dev
# if you want pyramid, the recommended application server
apt-get install pyramid-cubicweb
# or if you want twisted (considered deprecated)
apt-get install cubicweb-twisted
``cubicweb`` installs the framework itself, allowing you to create new
instances. ``cubicweb-dev`` installs the development environment
allowing you to develop new cubes.
......@@ -155,7 +161,11 @@ Make sure to choose the correct architecture and version of Python.
Finally, install |cubicweb| and its dependencies, by running::
pip install cubicweb
# for pyramid, the recommended application server
pip install cubicweb[pyramid]
# or for twisted, considered deprecated (used by "cubicweb-ctl")
pip install cubicweb[etwist]
Many other :ref:`cubes <AvailableCubes>` are available. A list is available at
`PyPI <>`_
......@@ -8,11 +8,17 @@ Get a blog running in five minutes!
For Debian or Ubuntu users, first install the following packages
cubicweb, cubicweb-dev, cubicweb-blog
cubicweb, cubicweb-dev, cubicweb-twisted, cubicweb-blog
Windows or Mac OS X users must install |cubicweb| from source (see
:ref:`SourceInstallation` and :ref:`WindowsInstallation`).
You can also install those packages using pip in a virtualenv::
virtualenv venv
source venv/bin/activate
pip install cubicweb[etwist] cubicweb-dev cubicweb-blog
Then create and initialize your instance::
cubicweb-ctl create blog myblog
......@@ -31,7 +37,12 @@ your instance by using: ::
The `-D` option activates the debugging mode. Removing it will launch the instance
as a daemon in the background, and ``cubicweb-ctl stop myblog`` will stop
it in that case.
it in that case.
.. Note::
If you get a traceback when going on the web interface make sure your
version of twisted is **inferior** to 17.
About file system permissions
......@@ -67,4 +78,3 @@ Other parameters, like web server or emails parameters, can be modified in the
You'll have to restart the instance after modification in one of those files.
This is it. Your blog is functional and running. Visit http://localhost:8080 and enjoy it!
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment