Skip to content

Commit

Permalink
Create README.md
Browse files Browse the repository at this point in the history
Fixes #1
  • Loading branch information
kevinquillen authored Dec 30, 2023
1 parent 325535f commit 14ea5e3
Showing 1 changed file with 37 additions and 0 deletions.
37 changes: 37 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
[![tests](https://github.com/kevinquillen/ddev-typesense/actions/workflows/tests.yml/badge.svg)](https://github.com/kevinquillen/ddev-typesense/actions/workflows/tests.yml)

## Installation

Uses the current stable release of the Typesense Docker image.

With DDEV installed, run this command:

`ddev get kevinquillen/ddev-typesense`

## Configuration

The Typesense container is reached at hostname: "typesense", port: 8108. Outside of the container, you can visit `127.0.0.1:8109/health` in your browser to verify health status.

The default API key for Typesense is `ddev`. You can provide your own by adding to `.ddev/.env` in your project, and adding the `TYPESENSE_API_KEY` variable:

`TYPESENSE_API_KEY=my_api_key_value`

## Admin Dashboard

This DDEV addon also includes the admin dashboard by bfritscher:

https://github.com/bfritscher/typesense-dashboard

The admin dashboard is useful to navigate your collections and schema and debug your search.

You can access the admin dashboard by navigating to this URL in your browser:

`http://typesense.(DDEV_HOSTNAME):8109/#/login`

To login, provide the configured API key, `127.0.0.1` as the hostname, and `8108` as the port. Leave the path blank.

# Drupal and Search API

If you are using Drupal, you can use Search API and the Search API Typesense modules to connect to the running Typesense instance.

**Originally Contributed by [kevinquillen](https://github.com/kevinquillen)**

0 comments on commit 14ea5e3

Please sign in to comment.