mivodev.github.io/docs/guide/docker.md

title

title
Docker Guide

Docker Guide

This Docker image is built on Alpine Linux and Nginx, optimized for high performance and low resource usage.

Quick Start

Run MIVO in a single command:

docker run -d \
  --name mivo \
  -p 8080:80 \
  -e APP_KEY=base64:YOUR_GENERATED_KEY \
  -e APP_ENV=production \
  -v mivo_data:/var/www/html/app/Database \
  -v mivo_config:/var/www/html/.env \
  mivodev/mivo:latest

Open your browser and navigate to http://localhost:8080.

Initial Setup: If this is your first run, you will be redirected to the Web Installer. Follow the on-screen instructions to create the database and admin account.

Docker Compose

For a more permanent setup, use docker-compose.yml:

services:
  mivo:
    image: mivodev/mivo:latest
    container_name: mivo
    restart: unless-stopped
    ports:
      - "8080:80"
    environment:
      - APP_ENV=production
      - TZ=Asia/Jakarta
    volumes:
      - ./mivo-data:/var/www/html/app/Database

Tags

• latest: Stable release (recommended).
• edge: Bleeding edge build from the main branch.
• v1.x.x: Specific released versions.

Environment Variables

Variable	Description	Default
APP_ENV	Application environment (production or local).	production
APP_DEBUG	Enable debug mode (true or false).	false
APP_KEY	32-character random string (base64). Auto-generated on first install if not provided.
TZ	Timezone for the container.	UTC

Volumes

Persist your data by mounting these paths:

• /var/www/html/app/Database: Stores the SQLite database and session files. (Critical)
• /var/www/html/public/assets/img/logos: Stores uploaded custom logos.

Support the Project

If you find MIVO useful, please consider supporting its development. Your contribution helps keep the project alive!

---

Created with by MivoDev

Updating MIVO

To update MIVO to the latest version (e.g. from v1.2.2 to v1.2.3):

Using Docker Run:

# 1. Pull the latest image
docker pull mivodev/mivo:latest

# 2. Stop and remove the old container
docker stop mivo
docker rm mivo

# 3. Run the new container (use the same command as before)
docker run -d --name mivo -p 8080:80 ...

Using Docker Compose:

# 1. Pull the latest image
docker-compose pull

# 2. Recreate the container
docker-compose up -d