vichan/docker/doc.md

Vichan Docker Setup

The php-fpm process runs containerized.
The PHP application always uses /var/www as its work directory and home folder. If /var/www is bind mounted, you must adjust the path passed via FastCGI to php-fpm.

To fix this:

1. Adjust the root path: Set fastcgi_param SCRIPT_FILENAME to /var/www/$fastcgi_script_name; in your nginx config.

The default Docker Compose settings are meant for development and testing.

Expected folder structure:

<vichan-project>
└── local-instances
    └── 1
        ├── db
        └── www

To run the app:

1. Start all containers: Run docker compose up -d --build at the root of vichan directory
2. Rebuild just the PHP container: Run docker compose up -d --build php (useful during development)

---

PHP File Size Limit

To upload larger files, increase the default PHP file size limit (2MB). Since this setup uses Docker, follow these steps:

1. Open the config file: Edit ./docker/php/php.ini in your project directory.
2. Add or update these lines to increase the file size limit to 10MB:

   upload_max_filesize = 10M
   post_max_size = 10M
   

3. Restart your containers to apply the changes:

   docker compose restart
   

---

By default, PHP limits file uploads to 2MB — so increasing this is often required when uploading images or documents.

---

Using the .env File

Environment variables for the Docker Compose setup can be managed easily using a .env file.

Steps to Use It:

1. Copy the example: Start by copying .env.example to .env

   cp .env.example .env
   

2. Edit .env: Please make sure to change the default passwords for your setup.

What It Controls:

• Instance folder reference (e.g. local-instances/0)
• Database credentials
• Redis connection details
• Secure login
• Optional SSL certificate paths for nginx