Skip to content

Latest commit

 

History

History
174 lines (112 loc) · 5.5 KB

README.md

File metadata and controls

174 lines (112 loc) · 5.5 KB
Raw

Chevereto Docker

::: tip Installation service available We offer a paid installation service for this guide. We will install Chevereto Docker for you, including all the requirements and configurations. :::

Roll your own multi-website Chevereto infrastructure with Chevereto Docker, a Docker-based system that allows you to deploy and maintain one or multiple Chevereto websites on demand.

By the end of this tutorial, you'll have your own Chevereto Docker up and running, capable of deploying and maintaining multiple Chevereto websites on demand, all with automatic sub-domain creation and renewable HTTPS certificates.

Advantages

There are several advantages of our Docker system:

  • Run multiple websites with ease
  • Portability
  • Easy to update
  • Automatic HTTPS setup
  • CloudFlare integration

Repository

Check the project repository at chevereto/docker for all instructions and source code.

Requirements

To follow this guide, make sure you have:

  • Ubuntu server with shell access and public IP address.
  • Domain managed by CloudFlare (if using integration)
  • Chevereto license (required for the paid edition)

Getting a server

You'll need a server where you can install Chevereto Docker For this guide we recommend an Ubuntu 24.04 server, but any Unix-like system will do.

Accessing server shell

To interact with your server use a terminal emulator. Here are some terminal emulator software by operating system:

System Software
macOS Terminal, iTerm 2
Windows Windows Terminal, Putty
Linux Gnome Terminal, Tilix, XTerm

Access your server via SSH using the following command from your computer:

ssh root@<server ip>

Make sure to check your server provider's documentation for specific instructions on accessing the shell.

Installing chevereto/docker

Start by installing Chevereto Docker repository and its dependencies by running the following command.

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

Setting up CloudFlare integration

Skip this section if you don't need CloudFlare integration to manage domain DNS.

Integrate Chevereto Docker with CloudFlare to automate sub-domain creation for your websites. If you aren't using CloudFlare go to cloudflare.com to get started, it is free. Add your domain to continue with this guide.

To setup CloudFlare with Chevereto Docker:

  • Navigate to the DNS configuration for your domain on CloudFlare.
  • Create a new A record, take note as it will be your CLOUDFLARE_A_NAME environment value. Use the following properties:
    • Type: A
    • Name: chevereto-factory
    • Content: {server ip}
    • Proxy status: DNS only
    • TTL: Auto
  • Navigate to SSL/TLS configuration and under Overview set mode to Full (strict).

Next create an API token, take note as it will be your CLOUDFLARE_TOKEN environment value.

  • Go to api-tokens and click on Create Token
  • Use template Edit zone DNS
  • Permissions: Zone DNS Edit
  • Resources: Include Specific zone DOMAIN

You will require to take note on CLOUDFLARE_ZONE_ID and CLOUDFLARE_ACCOUNT_ID which you can get from the domain overview.

Create configuration (.env file)

To create the configuration file run the following command and follow the on-screen instructions.

make env
  • CHEVERETO_LICENSE_KEY: Your Chevereto license key (required for the paid edition, leave empty for free edition).
  • DOMAIN: The domain/hostame you'll use for spawning Chevereto installations.
  • EMAIL_HTTPS: The email to receive HTTPS certificate notifications from Let’s Encrypt.
  • CLOUDFLARE_* options: Integration details for CloudFlare.

Setting up system

By setting up the system you will enable background processing and nginx ingress HTTP proxy.

To set up the system run the following command:

make setup

Building the Chevereto image

If you're using free edition you can skip this step, as the image is freely available on GitHub Container Registry.

Build the Chevereto container image for the latest release by running the following command.

make image

Deploying

To deploy a new website use the following command format:

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

Replace {namespace} with the desired sub-domain and {email} with the admin email for the website.

For example:

make deploy NAMESPACE=demo [email protected]

The Chevereto website will be available within seconds as the new sub-domain propagates.

Upgrading

To upgrade you need to (1) Sync repository, (2) Re-build the container image, and (3) Update Chevereto instances.

Step 1: Sync repository

Sync this repository to get the latest changes.

make sync

Note: If there's a new branch (for example 4.2) switch to that branch running the following command:

git switch 4.2

Step 2: Re-build the container image

Build a new container image to reflect the newest release.

make image

Step 3: Update Chevereto instances

This will down and re-up the containers and carry the required database update.

make update