Metabase with Docker 🐳

A production-ready setup for running Metabase with PostgreSQL using Docker.

🚀 Quick Start

1. Clone this repository
2. Configure your environment:

cp .env.example .env
# Edit .env with secure credentials

3. Launch the stack:

docker compose up -d

📝 Access Metabase at localhost:3000

🛠️ Management Commands

# Monitor logs
docker compose logs -f

# Service operations
docker compose restart    # Restart all services
docker compose down       # Stop all services
docker compose down -v    # ⚠️ Stop and erase all data

# Backup database
./backup.sh

📈 Upgrade Metabase

Warning

Upgrading involves data risks. Please read the official upgrade guide and backup your data first!

To upgrade Metabase:

1. Choose a version tag from DockerHub
2. Update the version in docker-compose.yml:

   services:
     metabase:
       image: metabase/metabase:v0.x.y

3. Apply the upgrade (on startup, Metabase will perform the upgrade automatically.):

   docker compose pull metabase_app   # Download new version
   docker compose up -d               # Deploy update

4. Verify the upgrade:

   docker compose ps                  # Check container status
   docker compose logs metabase_app   # Monitor for errors

⚡ Production Considerations

• Security: Deploy behind a reverse proxy (nginx, traefik) with SSL
• Backups: Implement off-site backup strategy
• Monitoring: Set up container health monitoring
• Updates: Enable automated security updates

🔍 Troubleshooting

Run these commands if you encounter issues:

docker compose ps              # Check container status
docker compose logs metabase   # View Metabase logs