Docker

🔔 Subscribe to don't miss any update regarding Chevereto.

Dockerfile driven template project for building images and manage containers for Chevereto V4 projects.

Warning

: Do not publish Docker images to a public registry when using a paid Chevereto edition as its commercial license restricts re-distribution rights.

Features

• One-click commands using make
• Built-in HTTP ingress using nginx-proxy for multiple instances
• Automatic renewable HTTPS using Let's Encrypt
• One-click Chevereto updates
• Integrated with CloudFlare API (automatic sub-domain handling)
• Pure Docker instructions

Quick-start

Run the following command to install this project and all its dependencies in your brand new Ubuntu 22.04 server.

bash <(curl -s https://chevereto.com/sh/ubuntu/22.04/docker.sh)

Create configuration file at .env by running this command.

make env

Run the following command to setup the system.

make setup

If using Chevereto paid edition, build the Chevereto image by running this command.

make image

Deploying websites

To deploy a new website use the following command format.

make deploy NAMESPACE={namespace} ADMIN_EMAIL={email}

Replace {namespace} with the desired project name and {email} with the admin email for the website.

Destroying websites

To destroy a website use the following command format.

make destroy NAMESPACE={namespace}

Replace {namespace} with the desired project name to destroy.

Requirements

• Chevereto V4 license key (for paid edition)
  • Purchase new license
  • Access existing purchase
• Server with
  • Shell access
  • make, unzip, curl, jq and git
  • Docker
  • Compose V2 docker compose
• Hostname pointing to server
• See CLOUDFLARE when using CloudFlare

Pure Docker

Refer to PURE-DOCKER for a complete pure Docker command reference.

docker run -d \
  --name chevereto \
  -p 80:80 \
  -e CHEVERETO_DB_HOST=database \
  -e CHEVERETO_DB_USER=chevereto \
  -e CHEVERETO_DB_PASS=user_database_password \
  -e CHEVERETO_DB_PORT=3306 \
  -e CHEVERETO_DB_NAME=chevereto \
  -e CHEVERETO_ASSET_STORAGE_TYPE=local \
  -e CHEVERETO_ASSET_STORAGE_URL=/images/_assets/ \
  -e CHEVERETO_ASSET_STORAGE_BUCKET=/var/www/html/images/_assets/ \
  -v /var/www/html/images/ \
  ghcr.io/chevereto/chevereto:latest

Manual setup

• Clone this repository chevereto/docker (see SETUP)

git clone https://github.com/chevereto/docker.git

• Get Docker in your Ubuntu server

make install-docker

You may also check Docker for Desktop and Docker Engine (servers) instructions.

• Create .env configuration file

make env

• Create Cron (see SETUP)

make cron

• Create nginx-proxy

make proxy EMAIL_HTTPS=mail@yourdomain.tld

Build Chevereto image

💡 Omit this step when using free edition as the image is available at GHCR.

• Create Chevereto image (see SETUP)

make image

Create a NAMESPACE

• Setup a NAMESPACE for your website project

make namespace NAMESPACE=yourproject HOSTNAME=yourdomain.tld

Documentation

• SETUP
• NAMESPACE
• BUILDING
• DOCKER-COMPOSE
• VOLUMES
• HTTPS
• CLOUDFLARE
• UPDATING
• PERSISTENT
• FEEDBACK