Back to all templates
Weaviate logo

Weaviate

Database1024MB+ RAM

AI-native vector database for semantic search and RAG applications

databasevectoraisemantic-searchrag

Deploy Weaviate in 3 Steps

1

Connect Your VPS

Add your server credentials to Server Compass

2

Select Weaviate

Choose from our template library

3

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required
Step-by-step deployment guide

Deploy Weaviate on a VPS with Server Compass

Use the Weaviate template in Server Compass to deploy an AI-native vector database on your VPS, then verify the REST readiness endpoint.

About 10 minutesBrowser verified
1
Step 1

Open the server Apps tab

Select the tutorial-vps VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.

Server Compass Apps tab before creating a Weaviate app
2
Step 2

Choose an app template

Click New App and choose the template deployment path so Server Compass can load the built-in catalog.

Choosing to deploy an app from a Server Compass template
3
Step 3

Search for Weaviate

Use the template picker search to find Weaviate in the Server Compass template catalog.

Searching for Weaviate in the Server Compass template picker
4
Step 4

Select the Weaviate template

Choose the Weaviate template. Server Compass fills the Weaviate container, persistent data volume, REST port, gRPC port, anonymous access setting, and vectorizer configuration.

Weaviate template selected in Server Compass
5
Step 5

Review the Weaviate settings

Confirm the app name and compose service. In this run, the app was named weaviate-demo and used host port 8080.

Reviewing Weaviate project settings and compose services
6
Step 6

Deploy Weaviate

Review the generated environment values, confirm the REST and gRPC ports are available, and click Deploy Now.

Reviewing Weaviate environment variables and port before deployment
7
Step 7

Watch the deployment progress

Keep the deployment modal open while Server Compass uploads the compose file, pulls the Weaviate image, starts the container, and verifies the stack.

Server Compass deploying the Weaviate template on the VPS
8
Step 8

Confirm Weaviate is running

After deployment finishes, return to the Apps tab and confirm the Weaviate app is marked Running with the database port available.

Weaviate template running in the Server Compass Apps tab
9
Step 9

Verify Weaviate is reachable

Open the app detail view and verify the running Weaviate container. In this tutorial run, the REST readiness endpoint reported that Weaviate was ready.

Weaviate app detail screen after verifying the deployed database container

After Weaviate Opens

  • Enable authentication before production use; this template enables anonymous access by default.
  • Configure vectorizer modules or external embedding pipelines before production ingestion.
  • Restrict external access to port 8080 and the gRPC port unless remote clients explicitly need them.
  • Configure regular backups for the Weaviate data volume before storing production data.
  • Use HTTPS before exposing the Weaviate API publicly.

Verified Result

The Weaviate REST API returned ready status from a curl request.

Weaviate deployment questions

What does the Weaviate template deploy?

It deploys a Weaviate container with a persistent data volume, REST API port, gRPC port, anonymous access enabled, and vectorizer set to none.

Which port did the tutorial use?

The tutorial used host port 8080, which maps to Weaviate REST API port 8080. The template also exposes a gRPC port.

Why is there no browser verification screenshot?

Weaviate exposes a service API rather than a conventional browser app. The tutorial verifies it with the REST readiness endpoint.

Should this become a blog post?

No. The deployment guide should live on the Weaviate template detail page and be linked from the reusable template deployment docs page.

Terminal Deployment

Weaviate CLI Deployment

Deploy Weaviate the traditional way with SSH and Docker Compose.

1

Open a Terminal Connection

Start by opening a terminal window and connecting to your VPS via SSH.

terminal
# Connect to your VPS
ssh root@your-server-ip

# Or with a specific SSH key
ssh -i ~/.ssh/your-key root@your-server-ip

First time? Docker required! Install it with: curl -fsSL https://get.docker.com | sh

2

Create Application Directory

Create a dedicated space for your application deployment.

terminal
# Create and navigate to project directory
mkdir -p ~/apps/weaviate
cd ~/apps/weaviate
3

Create Deployment Configuration

Create a docker-compose.yml file with the following configuration:

docker-compose.yml
services:
  weaviate:
    image: semitechnologies/weaviate:latest
    ports:
      - "8080:8080"
      - "50051:50051"
    environment:
      - QUERY_DEFAULTS_LIMIT=25
      - AUTHENTICATION_ANONYMOUS_ACCESS_ENABLED=true
      - PERSISTENCE_DATA_PATH=/var/lib/weaviate
      - DEFAULT_VECTORIZER_MODULE=none
      - CLUSTER_HOSTNAME=node1
    volumes:
      - weaviate_data:/var/lib/weaviate
    restart: unless-stopped

volumes:
  weaviate_data:
Deployment Settings
PORTREST API port(default: 8080)
GRPC_PORTgRPC port(default: 50051)
4

Launch Your Application

Deploy the stack and monitor the startup process.

terminal
# Spin up containers
docker compose up -d

# Verify deployment
docker compose ps

# Check logs for errors
docker compose logs -f
5

Enable External Access

Set up firewall rules to permit incoming connections.

terminal
# Allow the application port through firewall
sudo ufw allow 8080/tcp
sudo ufw reload

# Access your app at:
# http://your-server-ip:8080
Skip the Terminal

Skip the command line. Deploy visually.

Server Compass makes deploying Weaviate effortless. Visual setup, one-click deploy, done.

  • Visual config editor
  • Instant deployment
  • Automatic HTTPS
  • Smooth updates
  • Live monitoring
  • Quick rollbacks
Download Server Compass$29 one-time • Lifetime license

After Deployment

After deploying Weaviate with Server Compass, complete these steps to finish setup

1

Access REST API

2

Create schema and classes

3

Configure vectorizers if needed

Need help? Check out our documentation for detailed guides.

Weaviate FAQ

Common questions about self-hosting Weaviate

How do I deploy Weaviate with Server Compass?

Simply download Server Compass, connect to your VPS, and select Weaviate from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.

What are the system requirements for Weaviate?

Weaviate requires a minimum of 1024MB RAM. We recommend a VPS with at least 2048MB RAM for optimal performance. Any modern Linux server with Docker support will work.

Can I migrate my existing Weaviate data?

Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard Weaviate backup and restore procedures.

How do I update Weaviate to the latest version?

Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest Weaviate image will be pulled and deployed with zero downtime.

Is Weaviate free to self-host?

Weaviate is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.

Ready to Self-Host Weaviate?

Download Server Compass and deploy Weaviate to your VPS in under 3 minutes. No Docker expertise required.

Download Server Compass