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

Quick Start

Get Journiv running in minutes to explore all features. Perfect for testing and evaluation.

Docker

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

Podman

Run Journiv with Podman - Docker alternative.

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	Quick testing, single-server deployments	Low	Yes
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