Install Meve

Specs

  • Operating System: Ubuntu with Docker installed. Windows is supported, but not recommended.

  • Required software: Docker and Docker Compose Plugin (see instructions below)

  • Database: Postgres, it will be set up automatically using Docker

Installation options

Ubuntu/Debian with Docker (recommended)

This instruction will guide you to install Meve as well as its database (PostgreSQL) as Docker containers. You may want to consider installing and managing database separately for production use.

  1. Install Docker using official docs on Ubuntu

  2. Run docker login on Ubuntu (email us and we’ll provide the credentials)

  3. Download and unzip the configs. There are 3 places where it’s advisable to change passwords:

    • 1 password in init.sql

    • 2 passwords in docker-compose.yml: db.pass must the same as the password in init.sql, while POSTGRES_PASSWORD can be anything

    • Don’t change any usernames

  4. Edit docker-compose.yml and replace !PUT VERSION HERE! with a real version that you received from us via email

  5. Step into the folder in the terminal and run docker compose up -d

  6. Now you can open it in your browser: http://[ip-address-of-ubuntu-machine]:8080

Besides the app itself, this starts Postgres DB inside as a Docker container too. If you want more scalable/reliable set up, you may want to consider setting up Postgres on a separate machine with backups & failover setups. Or use cloud versions.

Upgrade

If you used Docker for the installation, all you need to do is:

  1. Update the version in docker-compose.yml

  2. docker compose pull (optional, downloads the new version so that the next command executes with minimal downtime)

  3. docker compose up -d