Note: The recommended install method is to use the
prompt-installmethod 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://github.com/diversen/coscms.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:
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.
In your /etc/apache2/sites-available/yoursite.org, 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):
./coscli.sh apache2 --enable yoursite.net
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.
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):
./coscli.sh 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
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.
./coscli.sh 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:
./coscli.sh install --install --master default
Add A Super User
Execute the following command which will create a super user for you:
./coscli.sh useradd --add
Create an email user, you should be able to login at the following address:
Share a link to this on email, Google+, Twitter, Facebook.