Meilisearch Server

This section covers the Meilisearch server features Depfloy provides for managing your search infrastructure.

Meilisearch is a powerful, fast, and open-source search engine that provides instant search experiences. Depfloy makes it easy to deploy and manage Meilisearch servers with just a few clicks.

Creating a Meilisearch Server

To create a new Meilisearch server:

1. Navigate to the Servers section in your Depfloy dashboard
2. Click Add Server and select your cloud provider (or you can choose to manually setup your VPS)
3. Choose Meilisearch as the server type
4. Set your Meilisearch master key or generate a new one
5. Click Create Server to provision your Meilisearch instance

Once the server has been provisioned, Deploy will automatically install and configure Meilisearch with secure default settings. The default port for Meilisearch is 7700, and this will be added to the firewall rules automatically.

Connection Details

After your Meilisearch server is created, you can find the connection details on the server details page at https://app.depfloy.com/servers/<serverID>/meilisearch.

The following connection information is available:

Parameter	Description
Host	The public IP address of your server
Port	7700 (default Meilisearch port)
Master Key	Your secure API key for authentication
API URL	Full URL for API requests (e.g., http://<host>:7700)

You can use these details to connect your applications to the Meilisearch instance. For quick access, click the Copy API URL button to copy the full connection URL to your clipboard.

Configuration Management

Depfloy allows you to view and modify your Meilisearch configuration directly from the dashboard.

Viewing Configuration

Navigate to the Configuration tab on your Meilisearch server page to view the current settings.

Configuration Parameters

The following configuration parameters can be managed:

Parameter	Description	Default
db_path	Path where Meilisearch stores its data	/var/lib/meilisearch/data
http_addr	Address and port Meilisearch listens on	0.0.0.0:7700
master_key	API key for secure access	Auto-generated
env	Environment mode (development or production)	production
max_indexing_memory	Maximum RAM for indexing operations	2 Gb
log_level	Verbosity of logs (ERROR, WARN, INFO, DEBUG, TRACE)	INFO

Editing Configuration

1. Click the Edit Configuration button
2. Modify the desired parameters
3. Click Save Changes
4. The Meilisearch service will automatically restart to apply the new configuration

Master Key Management

The master key is essential for securing your Meilisearch instance. It is used to authenticate API requests and should be kept confidential.

Viewing the Master Key

1. Navigate to your Meilisearch server details page
2. Click View Master Key to reveal the current key
3. Use the Copy button to copy the key to your clipboard

Generating a New Master Key

If your master key is compromised or you need to rotate credentials:

1. Click the Generate New Key button
2. Confirm the action in the dialog
3. The new key will be generated and the Meilisearch service will restart

Service Management

Depfloy provides tools for managing the Meilisearch service running on your server.

Restarting the Service

To restart the Meilisearch service:

1. Navigate to your server details page
2. Click the Restart Service button
3. Confirm the restart action

The service will be restarted and should be available again within a few seconds.

Viewing Error Logs

To troubleshoot issues or monitor your Meilisearch instance:

1. Navigate to the Logs tab on your server page
2. View real-time logs from the Meilisearch service
3. Use the filters to search for specific log levels or time ranges

Logs are helpful for debugging indexing issues, monitoring search performance, and identifying configuration problems.