Download & installation
Woost is open source software, and can be freely downloaded by anyone. The CMS is divided into two packages: Woost itself, which contains everything specific to the CMS; and Cocktail, its underlying web development framework. Both projects are hosted at BitBucket:
On the following sections we will go over the steps required to install the code and create a working instance of the CMS.
The installation script
The installation of Woost can be an involved process, requiring quite a few dependencies and steps. In order to streamline this, we provide a script that does all the work for you. So far it only works on Debian / Ubuntu (tested on Ubuntu 14.04 and 16.04); we may extend it to support other platforms in the future.
Downloading the script
The first step is to download the installation script, which you can get at the following address:
You must download and save the script (typically, by right clicking the link and choosing Save link as, or by opening it and pressing ctrl + s).
Bootstraping the system
Now that we have downloaded the script, we will use it to install the preliminary requisites needed to complete the installation process. We'll do that by opening a terminal and applying the script's
python woostproject.py bootstrap
This should be done once on each host where you intend to host a Woost website. So if you are creating or deploying a second website on the same host, you can safely skip this step (and don't fear, running it twice is innocuous).
Creating a new project
Next, we will create our brand new website. To do so we will use the script's
new command. Here's an example:
python woostproject.py new MyProject \ --workspace /path/to/your/workspace \ --hostname mydomain \ --language en fr de \ --admin-email email@example.com \ --admin-password MyP4ssw0rd
As you can see, the
new command takes a lot of parameters. Lets go over each of them:
MyProjectis the name of the project you want to create. This will be used as the name of the folder containing the project's structure, and to name some classes and packages in the generated source code. As such, it should be a name that uniquely identifies your project, written in TitleCase.
--workspace /path/to/your/workspaceparameter tells the installer where it should place the folder for your project. Typically you'll want to use the path to the folder where you store all your development projects. If you don't have one, just choose the path that you prefer. Note that you can also set this parameter by setting a
--hostnameshould specify the hostname that you will use to access this website. If you are not running your own DNS server, you may want to use the
--modify-hosts-fileoption and invent any hostname you want.
--languageshould be a list of the languages you want your website to be available in. Languages are indicated using ISO-639-1 codes. Note that you can add further languages after the installation is complete.
--admin-emailshould be set to the email address of the administrator user, which you will use to access the site's backoffice. If you don't supply this parameter, the script will ask you to input it during the installation.
--admin-passwordindicates the password for the administrator user. Again, the script will prompt you for it if you don't specify this parameter. Note that neither method is specially secure; you probably want to specify a temporary password and use the backoffice to change it right away.
If everything goes according to plan, the script should set off to work and begin downloading, installing and compiling all the pieces required to run your project.
Launching your project
Once the installation is complete, you are ready to launch your website. Woost websites require launching two different processes in order to work: the database server and the web server.
If you have
gnome-terminal installed, the script will have created a handy launcher for you that will start your website with a single click. Look for it on your applications menu (should be named like your project).
The launcher opens a terminal with several tabs:
- The first tab holds the database server (ZEO). Here you can see the database log, or shut down the database (by pressing ctrl + c), if you need to do some maintenance.
- The second tab contains the application's web server. By default, this tab will display HTTP requests and your application's standard output.
- The next three tabs are regular shell sessions, with their working directory set to the folders containing the source code for Cocktail, Woost and your own project. Note that you also get
SITEenvironment variables pointing to these folders.
- The final tab holds an iPython session of your project
shell.pyscript. This provides convenient programatic access to your project's database.
With the launcher running, just point your web browser to your chosen hostname. If everything went well, you should see your new website, with a link to the site's backoffice.