forked from GithubBackups/vichan
64 lines
1.9 KiB
Markdown
64 lines
1.9 KiB
Markdown
# 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:
|
|
```ini
|
|
upload_max_filesize = 10M
|
|
post_max_size = 10M
|
|
```
|
|
3. **Restart your containers** to apply the changes:
|
|
```bash
|
|
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`
|
|
```bash
|
|
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
|