2. Install — Mroonga vmrn_version documentation

Skip to main content
`Ctrl`+`K`

# 2. Install

This section describes how to install Mroonga on each environment. There are packages for major platforms. It’s recommended that you use package instead of building Mroonga by yourself. But don’t worry. There is a document about building Mroonga from source.

We distribute both 32-bit and 64-bit packages but we strongly recommend a 64-bit package for server. You should use a 32-bit package just only for tests or development. You will encounter an out of memory error with a 32-bit package even if you just process medium size data.

- 2.1. Windows
  - 2.1.1. Install
    - 2.1.1.1. Download and extract the zip file
    - 2.1.1.2. Run `mariadb-install-db.exe`
    - 2.1.1.3. Start MariaDB server command
    - 2.1.1.4. Install Mroonga to MariaDB
  - 2.1.2. Build from source with MariaDB
- 2.2. macOS
  - 2.2.1. Homebrew
- 2.3. Debian GNU/Linux
  - 2.3.1. bookworm (MariaDB)
  - 2.3.2. bookworm (with the Oracle MySQL 8.0 package)
  - 2.3.3. trixie (MariaDB)
  - 2.3.4. trixie (with the Oracle MySQL 8.4 package)
- 2.4. Ubuntu
  - 2.4.1. PPA (Personal Package Archive)
- 2.5. AlmaLinux
  - 2.5.1. AlmaLinux 8 (with the Oracle MySQL 8.0 package)
  - 2.5.2. AlmaLinux 8 (with the Oracle MySQL 8.4 package)
  - 2.5.3. AlmaLinux 8 (with Percona Server 8.0 package)
  - 2.5.4. AlmaLinux 8 (with MariaDB 10.6 package)
  - 2.5.5. AlmaLinux 8 (with MariaDB 10.11 package)
  - 2.5.6. AlmaLinux 8 (with MariaDB 11.4 package)
  - 2.5.7. AlmaLinux 8 (with MariaDB 11.8 package)
  - 2.5.8. AlmaLinux 9 (with the Oracle MySQL 8.0 package)
  - 2.5.9. AlmaLinux 9 (with the Oracle MySQL 8.4 package)
  - 2.5.10. AlmaLinux 9 (with Percona Server 8.0 package)
  - 2.5.11. AlmaLinux 9 (with Percona Server 8.4 package)
  - 2.5.12. AlmaLinux 9 (with MariaDB 10.6 package)
  - 2.5.13. AlmaLinux 9 (with MariaDB 10.11 package)
  - 2.5.14. AlmaLinux 9 (with MariaDB 11.4 package)
  - 2.5.15. AlmaLinux 10 (with the Oracle MySQL 8.4 package)
- 2.6. Oracle Linux
  - 2.6.1. Oracle Linux 8 (with the Oracle MySQL 8.0 package)
- 2.7. Fedora
  - 2.7.1. Fedora 21
- 2.8. Docker
- 2.9. Others
  - 2.9.1. Dependencies
    - 2.9.1.1. Tools
    - 2.9.1.2. Libraries
    - 2.9.1.3. MySQL
    - 2.9.1.4. MariaDB
  - 2.9.2. Build from source
    - 2.9.2.1. `cmake`
      - 2.9.2.1.1. `-DMYSQL_SOURCE_DIR=PATH`
      - 2.9.2.1.2. `-DMYSQL_BUILD_DIR=PATH`
      - 2.9.2.1.3. `-DMYSQL_CONFIG=PATH`
      - 2.9.2.1.4. `-DMRN_DEFAULT_TOKENIZER=TOKENIZER`
      - 2.9.2.1.5. `-DCMAKE_BUILD_TYPE={Release,Debug,RelWithDebInfo}`
      - 2.9.2.1.6. `-DCMAKE_INSTALL_PREFIX=PREFIX`
    - 2.9.2.2. `cmake --build`
    - 2.9.2.3. `cmake --install`
    - 2.9.2.4. `mysql -u root < install.sql`
    - 2.9.2.5. Uninstall Mroonga