# Create a Memorystore for Memcached instance by using the Google Cloud console

This quickstart walks you through the steps to create a Memorystore for Memcached
instance, connect to the instance, set a value, retrieve a value, and delete the
instance.

> [!CAUTION]
> **Caution:** You cannot create a Memorystore for Memcached instance without first having a private services access connection established. See [Networking](https://docs.cloud.google.com/memorystore/docs/memcached/networking.md.txt) for details on the private services access connection that is required for Memorystore for Memcached.

## Before you begin

1. Enable the Service Networking API for your project.   
   [Enable the Service Networking API](https://console.cloud.google.com/apis/library/servicenetworking.googleapis.com)
2. Enable the Memorystore for Memcached API for your project.   
   [Enable the Memorystore for Memcached API](https://console.cloud.google.com/apis/api/memcache.googleapis.com)

<br />

## Creating a Memcached instance

1. Go to the Memorystore for Memcached page in the Google Cloud console.

   [Memorystore for Memcached](https://console.cloud.google.com/memorystore/memcached/instances)  

2. Click the **Create Instance** button.

3. Select the configurations for your new instance on the **Create a Memcached
   instance** page in the Google Cloud console:

   - Enter an instance ID using only lowercase letters, numbers, and hyphens. Start with a letter.
     - For example, `my-memcached-instance-1`.
   - Choose `us-central1` from the **Region** dropdown.
   - Choose `Automatically distribute` from the **Zone** dropdown.
   - Enter `2` under **Nodes** to create two nodes.
   - Choose 1 GB of **Memory per node**.
   - Choose 1 for **Cores per node**.
   - Select `default` for the **Authorized network**.

     > [!NOTE]
     > **Note:** If you see the **Private service connection required** panel, you need to [establish a private services access connection](https://docs.cloud.google.com/memorystore/docs/memcached/establishing-connection).

4. Click **Create**.

5. After the instance is created, click the instance ID to view the instance
   details page.

6. Write down the `IP address` of one of your nodes.

## Connecting to your instance from a Compute Engine VM

> [!NOTE]
> **Note:** To connect to a Memcached instance, your client VM must be located in the same region, and must be connected to the same network, as your instance.

To test the connection:

1. Connect to a Linux VM. For steps to connect to a Linux VM, see [Quickstart Using a Linux VM](https://docs.cloud.google.com/compute/docs/create-linux-vm-instance.md.txt).
   If you used a Debian based image to create your VM instance as described in the
   quickstart, install `telnet` using `apt-get`:

       sudo apt-get install telnet

2. From the terminal, telnet to the IP address of one of the Memcached nodes.
   Replace <var translate="no">node-ip-address</var> with the IP address of your node.

   ```
   telnet node-ip-address 11211
   ```

   You should see the following output with the `[bracketed-variables]` replaced
   your project's variables:

   ```
   Trying [node-ip-address]…
   Connected to [node-ip-address]
   ```
3. In the telnet session, enter some Memcached commands:

   Enter:

   ```
   get greeting
   ```

   Result:

   ```
   END
   ```

   Enter:

   ```
   set greeting 1 0 11
   hello world
   ```

   Result:

   ```
   STORED
   ```

   Enter:

   ```
   get greeting
   ```

   Result:

   ```
   VALUE greeting 1 11
   hello world
   END
   ```

Memorystore for Memcached supports standard open source Memcached libraries.

## Clean up


To avoid incurring charges to your Google Cloud account for
the resources used on this page, follow these steps.

1. Go to the Memorystore for Memcached page in the Google Cloud console.

   [Memorystore for Memcached](https://console.cloud.google.com/memorystore/memcached/instances)  

2. Click the ID of the instance you want to delete.

3. Click the **Delete** button.

4. In the prompt that appears, enter the instance's ID.

5. Click the **Delete** button.

## What's next

- [Connect to a Memcached instance](https://docs.cloud.google.com/memorystore/docs/memcached/connecting-memcached-instance).

- [Use the Auto Discovery service](https://docs.cloud.google.com/memorystore/docs/memcached/using-auto-discovery).

- [Monitor your Memcached instance](https://docs.cloud.google.com/memorystore/docs/memcached/monitoring-instances).