No abstract yet


Install :: Step by Step Linux Install


    Note: The recommended install method is to use the prompt-install method as described here

    Please see the dependencies before you install the system. This is the long version of how to install the coscms system on your server. There is also an install script. This is the steps that the install scripts guide you through.

    Clone the Master

    git clone git://

    Now you have all the source you need. If you did not specify a clone directory then the source is located in coscms. Enter this directory:

    cd coscms

    Now you have all the source for the base system. Checkout which tags exists by doing a:

    git tag -l

    Then select the latest tag or choose the master. The master is checked out when cloning, and the master is usually quite stable. If you want to set a tag then do this:

    git checkout 1.721

    This will produce some git output like the following: "You are in 'detached HEAD' state." And some more. Don't take notice - it is OK. It is because it is not the master. If you have chosen the master then you will not get these warnings.

    Apache2 Configuration

    In your /etc/apache2/sites-available/, You need to set the document_root in apache to coscms/htdocs e.g.:


    You can also use this command (which will only work on Debian based systems):

    ./ apache2 --enable

    This will try to create an apache2 virtual host with correct configuration, and enable name in the /etc/hosts file. This is good for development - because then you can just use sitenames like mytestsite or costest.

    Create and edit config.ini file

    You now need a configuration file. In the profiles/osnet dir you will need to copy the config.ini-dist file into the config dir. Like this or in an other way:

    cp profiles/default/config.ini-dist config/config.ini

    Edit config/config.ini to match your database url, username and password, host (in short: all database settings). Also match enabled servername (this is for testing which user runs the server, e.g. www-data). Other settings include session time (in secounds) and cookie time (in days), default timezone. Some of these settings can be overloaded by web modules, e.g. locales.

    Create database

    If your db user (specified in config/config.ini) can create databases you can create the database with the following command (please note that the database and all tables will be destroyed):

    ./ db --load-db-default

    If your database user can not create databases, you have to create a database before install, e.g. with the MySQL command line tool, or any other way and then execute the SQL found in


    Install Profile

    A profile is basically a list of modules, templates, to install, some pre-defined configuration etc. We specify the default profile included in the distribution.

    ./ install --install default

    Now you will see that the command line will start to clone and install all module and template repos for this profile. If you have chosen the master, then you should add the 'master' option like this:

    ./ install --install --master default

    Add A Super User

    Execute the following command which will create a super user for you:

    ./ useradd --super

    Create an email user, you should be able to login at the following address:

    This page has been viewed 420 times. First hit: 21-Aug-2015 18:12:12
    Share email, Google+, Twitter, Facebook.
    comments powered by Disqus