Journiv can be installed using Docker Compose (recommended) or manually. Docker Compose is the easiest and most reliable method, providing consistent behavior across all platforms.

Docker

Production-ready installation with Docker Compose. Recommended for most deployments.

Manual Setup

Full control over installation and configuration. Best for development and custom deployments.

Prerequisites

Before installing Journiv, ensure you have:

Docker and Docker Compose installed (for Docker installation methods)
Python 3.9+ (for manual installation)
PostgreSQL 12+ (optional, SQLite is the default)
At least 512MB RAM (1GB+ recommended)
2GB disk space (more for media files)

Installation Methods Comparison

Method	Best For	Complexity	Production Ready
Docker Compose	Production deployments, multi-service setups	Medium	Yes
Manual	Development, custom configurations	High	Yes

Next Steps

After installation:

Complete Initial Setup - Visit your instance URL and create your first account
Configure Your Instance - See Configuration for environment variables and settings
Set Up HTTPS - Use a reverse proxy (nginx, Traefik, Caddy) for secure access
Connect Mobile Apps (coming soon) - Download the iOS/Android apps and connect to your server
Start Journaling - Create your first journal and entry!

Getting Help

If you encounter issues during installation:

Check the FAQ for common problems
Review the Troubleshooting Guide for detailed solutions
Join our Discord community for real-time help
Open an issue on GitHub

Installation