Memoh Deployment Guide

One-Click Install

curl -fsSL https://memoh.sh | sudo sh

Or manually:

git clone https://github.com/memohai/Memoh.git
cd Memoh
sudo docker compose up -d

On macOS or if your user is in the docker group, sudo is not required.

Access:

Default credentials: admin / admin123

Prerequisites

Docker (with Docker Compose v2)
Git

That's it. No containerd, nerdctl, or buildkit required on the host.

Custom Configuration

By default, Docker Compose uses conf/app.docker.toml (no file in project root is mounted; only this config file is mounted into the containers).

To use your own config, create and edit it in the project root, then point MEMOH_CONFIG at it (path is on the host; run docker compose from the project root):

cp conf/app.docker.toml config.toml
nano config.toml
sudo MEMOH_CONFIG=./config.toml docker compose up -d

Recommended changes for production:

admin.password - Admin password
auth.jwt_secret - JWT secret (generate with openssl rand -base64 32)
postgres.password - Database password

Common Commands

Prefix with sudo on Linux if your user is not in the docker group.

docker compose up -d          # Start
docker compose down           # Stop
docker compose logs -f        # View logs
docker compose ps             # Status
docker compose up -d --build  # Rebuild and restart

Production

Configure HTTPS (create docker-compose.override.yml with SSL certs)
Change all default passwords
Configure firewall
Set resource limits
Regular backups

Troubleshooting

docker compose logs server    # View service logs
docker compose logs containerd # View containerd logs
docker compose config         # Check configuration
docker compose build --no-cache && docker compose up -d  # Full rebuild

Security Warnings

Main service has privileged container access - only run in trusted environments
Must change all default passwords and secrets
Use HTTPS in production

2.1 KiB Raw Blame History