zaywalker/chevereto repository overview

⁠한국어 설명서는 여기로⁠

⁠zaywalker/chevereto:installer - Chevereto Installer

Chevereto⁠ is a powerful and fast image hosting script that allows you to create your very own full featured image hosting website in just minutes.

This offers to install with installer.php⁠ at Chevereto Get Started⁠ page on php 7.4 and apache2⁠ and support free and paid version.

⁠Supported tags

• installer - Using the installer script⁠

⁠Connection to database

Chevereto⁠ requires an Mysql database to store its information. You can use a Mysql⁠ or MariaDB⁠ container to host this.

Information on connection to database is provided to container via environment variables explained above.

⁠Persistent storage

In order to manage Chevereto⁠, I recommend that you mount⁠ the /var/www/html directory with your local directory. It makes you don't lose images, Cheverto HTML data, and updates (also your customized HTML data) if you relaunch/remove container.

You can find images uploaded by users in /var/www/html/images directory in your container or your mounted directory /your_mount/images.

⁠Max image size

By default, PHP allow a maximum file upload to be 2MB. You can change such behaviour by updating the /var/www/html/.htaccess in your container or mounted directory /your_mount/.htaccess.

php_value upload_max_filesize 10G
php_value post_max_size 10G
php_value memory_limit 1G
php_value max_execution_time 300
php_value max_input_time 300

⁠Real-ip behind reverse proxy⁠

If you run Chevereto behind reverse proxy⁠, you need to modify /var/www/html/app/settings.php in your container or mounted directory /your_mount/app/settings.php.

// Use X-Forwarded-For HTTP Header to Get Visitor's Real IP Address
if ( isset( $_SERVER['HTTP_X_FORWARDED_FOR'] ) ) {
        $http_x_headers = explode( ',', $_SERVER['HTTP_X_FORWARDED_FOR'] );
        $_SERVER['REMOTE_ADDR'] = $http_x_headers[0];
}

⁠Example Usage

I recommend you to use Docker-compose⁠ / Docker swarm⁠ to launch Chevereto in conjunction with a MySQL database. A sample of docker-compose.yaml can be found below.

⁠Docker compose

• Asia/Seoul - timezone
• your_mysql_root_password - MySQL root password to manage
• your_mysql_chevereto_dbname - Chevereto database name
• your_mysql_chevereto_username - Chevereto database username
• your_mysql_chevereto_user_password - Chevereto database user password
• /your_mount - Chevereto container's /var/www/html
• IP addresses - Chevereto access MySQL with service name, but it's good to change for your security.

version: '2.1'
services:
    mysql-chevereto:
      container_name: chevereto-mysql
      image: mariadb:10.5
      restart: always
      volumes:
        - mysql-vol-1:/var/lib/mysql/
      environment:
        # change timezone of yours and other values
        - TZ=Asia/Seoul
        - MYSQL_ROOT_PASSWORD=your_mysql_root_password
        - MYSQL_DATABASE=your_mysql_chevereto_dbname
        - MYSQL_USER=your_mysql_chevereto_username
        - MYSQL_PASSWORD=your_mysql_chevereto_user_password
      networks:
        chevereto-network:
          # change ip address of yours
          ipv4_address: 172.23.1.20
          aliases:
            - mysql

    web-chevereto:
      container_name: chevereto-web
      image: zaywalker/chevereto:installer
      restart: always
      depends_on:
        - mysql-chevereto
      volumes:
        # change mount point of yours
        - /your_mount:/var/www/html
      environment:
        # change timezone of yours
        - TZ=Asia/Seoul
      networks:
        chevereto-network:
          # change ip address of yours
          ipv4_address: 172.23.1.10
          aliases:
            - web

volumes:
  mysql-vol-1:

networks:
  chevereto-network:
    driver: bridge
    driver_opts:
      com.docker.network.bridge.name: br-chevereto
    ipam:
      driver: default
      config:
        # change subnet of yours
        - subnet: 172.23.1.0/24

Once docker-compose.yaml is ready, you can run

docker-compose up -d 

To run the service

⁠Standalone

docker run --name chevereto-web -d \
    -v /your_mount:/var/www/html \
    zaywalker/chevereto:installer

⁠Install chevereto

When the container is up and hooked up with your proxy, you can install chevereto with installer.php tail to visit at

http://your.chevereto.web/installer.php

And follow installation. the values are

• License key
  • Enter your purchased key or skip to use Chevereto-Free
• cPanel access
  • Your cPanel account. If you don't have, just skip
• Database Host
  • Your MySQL server host. If you followed docker compose example, it's mysql-chevereto
• Database Port
  • Your MySQL server port. If you followed docker compose example, it's 3306
• Database Name
  • Your MySQL chevereto database name. If you followed docker compose example, it's your_mysql_chevereto_dbname
• Database User
  • Your MySQL chevereto database username. If you followed docker compose example, it's your_mysql_chevereto_username
• Database User password
  • Your MySQL chevereto database user password. if you followed docker compose example, it's your_mysql_chevereto_user_password