coldcms 0.2.10

You have access to a ColdCMS instance and you want to create a website

You can find the user documentation here:

• English documentation

• Documentation en français

You want to install ColdCMS

You have two options: docker installation or manual installation.

cd docker && docker-compose up

docker exec -it docker_backend_1 python3 manage.py createsuperuser

[uwsgi]
socket = 0.0.0.0:8000
chdir = /srv/app/
module = coldcms.wsgi:application
master = true
processes = 4
threads = 2
uid = coldcms
gid = coldcms
buffer-size = 65535
env = BUILD_DIR=/srv/build
env = STATIC_ROOT=/srv/build/static/
env = SECRET_KEY=something_big_and_random

You are a developer and you want to quickly have a look

Note: this has only been tested on Linux environments.

Install ColdCMS with pypi:

pip install coldcms

Run the quick launch command:

python -m coldcms

Before this command you can set the following environment variables :

• RUN_DJANGO_MIGRATION=0: do not run the migrations

• SETUP_INITIAL_DATA=0: do not setup the initial data, in case you want to keep the data you already have in your coldcms database

• COLLECT_STATIC=0: do not collect the static files. Don’t set that variable to 0 if it is your first time launching ColdCMS.

• CREATE_SUPERUSER=0: do not create a new superuser (you can have several superuser at a time, but not with the same username or email)

• BUILD_ASSETS=0: do not build build assets. Don’t set that variable to 0 if it is your first time launching ColdCMS.

• BUILD_STATIC=0: do not build static files. Don’t set that variable to 0 if you’ve also set SETUP_INITIAL_DATA to 0.

Example: CREATE_SUPERUSER=0 python -m coldcms will run the migrations, setup some new initial data, but will not create a new superuser.

You are a developer and you want to contribute to ColdCMS

Clone the gitlab repository, and read the Dev section below to install the ColdCMS development environment.

Follow the contribution guidelines.

1. Install the dependencies

Install libjpeg and zlib, needed to work with images through the Pillow library. If you have a debian-based distribution, use the following commands:

sudo apt-get install zlib1g-dev
sudo apt-get install libjpeg-dev

Also, please install PurgeCSS and clean-css, to reduce the size of CSS files:

npm install -g purgecss@2.1.0 clean-css-cli@4.3.0

And to continue with javascript, please install static dependencies :

(cd coldcms/static/ && npm i --save-dev)

We use sass to transpile sass files to CSS. Make sure that the binary sass from the sassc package is present in your $PATH. In debian-based distributions, run the following:

sudo apt-get install sassc
sudo ln -s /usr/bin/sassc /usr/bin/sass # might be necessary if /usr/bin/sass doesn't exist after the previous command

Finally, run:

pip install -r requirements_dev.txt

2. Create a database

By default, ./manage.py migrate will create a sqlite3 database named coldcms.

• If you want to use a different database engine, you can specify it in the environment variable DB_URL. Make sure you have the proper database driver for the engine you want to use.

• If you want to use a different name for your sqlite database, you can specify it in the environment variable DB_NAME (useless for some engines as it is directly specified in the url - see table below).

As advised in the django documentation, if you’re new to databases, or you’re just interested in trying ColdCMS, use the default sqlite3 database, it is included in Python, so you won’t need to install anything else to support your database. When starting your first real project, however, you may want to use a more scalable database like PostgreSQL, to avoid database-switching headaches down the road.

Replace PATH, USER, PASSWORD, HOST, PORT and NAME with the correct values.

Source

For example, if you want to use PostgreSQL :

systemctl status postgresql # make sure postgresql is running
createdb coldcms # create the coldcms postgres database
sudo -u postgres psql
CREATE USER username PASSWORD 'password';
ALTER ROLE username WITH SUPERUSER;
\q
export DB_URL="postgres://username:password@localhost:5432/coldcms"

3. Launch the development server

./manage.py migrate
./manage.py collectstatic
./manage.py compilemessages
./manage.py createsuperuser
./manage.py setup_initial_data # optional - loads data of a basic home page
./manage.py runserver

If collectstatic doesn’t work, try :

cd coldcms/static && npm i
cd ../.. && ./manage.py assets build