|
| 1 | +--- |
| 2 | +title: "Deploy pgvector through the Linode Marketplace" |
| 3 | +description: "Deploy Pgvector, an open-source vector extension for PostgreSQL for similarity search and AI embeddings." |
| 4 | +published: 2026-02-09 |
| 5 | +modified: 2026-02-09 |
| 6 | +keywords: ['pgvector', 'postgresql', 'vector database', 'AI', 'embeddings', 'similarity search'] |
| 7 | +tags: ["ubuntu", "marketplace", "developer", "postgresql", "pgvector", "linode platform", "machine learning"] |
| 8 | +external_resources: |
| 9 | +- '[pgvector GitHub](https://github.com/pgvector/pgvector)' |
| 10 | +- '[pgvector Documentation](https://github.com/pgvector/pgvector#readme)' |
| 11 | +- '[PostgreSQL Documentation](https://www.postgresql.org/docs/)' |
| 12 | +aliases: ['/products/tools/marketplace/guides/pgvector/'] |
| 13 | +authors: ["Akamai"] |
| 14 | +contributors: ["Akamai"] |
| 15 | +license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)' |
| 16 | +--- |
| 17 | + |
| 18 | +Pgvector is an open-source PostgreSQL extension that enables vector similarity search directly inside a relational database. It allows you to store embeddings alongside structured data and perform nearest-neighbor searches using cosine similarity, inner product, or Euclidean distance—making it well-suited for AI, semantic search, and retrieval-augmented generation (RAG) workloads. |
| 19 | + |
| 20 | +## Deploying a Marketplace App |
| 21 | + |
| 22 | +{{% content "deploy-marketplace-apps-shortguide" %}} |
| 23 | + |
| 24 | +{{% content "marketplace-verify-standard-shortguide" %}} |
| 25 | + |
| 26 | +{{< note >}} |
| 27 | +**Estimated deployment time:** Pgvector should be fully installed within 5-10 minutes after the Compute Instance has finished provisioning. |
| 28 | +{{< /note >}} |
| 29 | + |
| 30 | +## Configuration Options |
| 31 | + |
| 32 | +- **Supported distributions:** Ubuntu 24.04 LTS |
| 33 | +- **Suggested plan:** Dedicated 16GB instance or higher for baseline development and testing with support for GPU instances. |
| 34 | + |
| 35 | +### Pgvector Options |
| 36 | + |
| 37 | +{{% content "marketplace-required-limited-user-fields-shortguide" %}} |
| 38 | + |
| 39 | +{{% content "marketplace-custom-domain-fields-shortguide" %}} |
| 40 | + |
| 41 | +{{% content "marketplace-special-character-limitations-shortguide" %}} |
| 42 | + |
| 43 | +### Obtain the Credentials |
| 44 | + |
| 45 | +When deployment completes, the system automatically generates credentials to administer your Pgvector instance. These are stored in the limited user’s `.credentials` file. |
| 46 | + |
| 47 | +1. Log in to your Compute Instance using one of the methods below: |
| 48 | + |
| 49 | + - **Lish Console**: Log in to Cloud Manager, click **Linodes**, select your instance, and click **Launch LISH Console**. Log in as `root`. To learn more, see [Using the Lish Console](/docs/products/compute/compute-instances/guides/lish/). |
| 50 | + - **SSH**: Log in to your instance over SSH using the `root` user. To learn how, see [Connecting to a Remote Server Over SSH](/docs/guides/connect-to-server-over-ssh/). |
| 51 | + |
| 52 | +2. Run the following command to access the contents of the `.credentials` file: |
| 53 | + |
| 54 | +```command |
| 55 | +cat /home/$USERNAME/.credentials |
| 56 | +``` |
| 57 | + |
| 58 | +## Getting Started after Deployment |
| 59 | + |
| 60 | +You can start by connecting to your PostgreSQL database |
| 61 | + |
| 62 | +```command |
| 63 | +psql -h localhost -U $POSTGRES_USER -d $POSTGRES_DB |
| 64 | +``` |
| 65 | +The connection credentials can be found in the `.credentials` file located at `/home/$USERNAME/.credentials`. |
| 66 | + |
| 67 | +You can then define vector columns and run similarity queries directly in SQL. |
| 68 | + |
| 69 | +Pgvector works with standard PostgreSQL clients and integrates easily with popular AI frameworks and ORMs: |
| 70 | + |
| 71 | + - **[psycopg](https://www.psycopg.org/)**: PostgreSQL adapter for Python |
| 72 | + - **[SQLAlchemy](https://www.sqlalchemy.org/)**: Python ORM with pgvector support |
| 73 | + - **[pgvector-node](https://github.com/pgvector/pgvector-node)**: Node.js client helpers |
| 74 | + - **[pgvector-go](https://github.com/pgvector/pgvector-go)**: Go utilities for pgvector |
| 75 | + |
| 76 | +If you want to learn more about Pgvector, check out the [official Pgvector documentation](https://github.com/pgvector/pgvector?tab=readme-ov-file#getting-started) to explore indexing strategies, performance tuning, and advanced query patterns. |
| 77 | + |
| 78 | +{{% content "marketplace-update-note-shortguide" %}} |
0 commit comments