Create a Classic Kafka service

Create a Classic Apache Kafka® service on Aiven. Classic Kafka uses predefined service sizes and stores data on local broker disks. You can enable tiered storage when the selected plan and cloud support it.

Prerequisites

• Access to the Aiven Console
• An Aiven project where you can create Kafka services

Create a Classic Kafka service on Aiven Cloud

Classic Kafka services are available on the Free and Professional service tiers. By default, data is stored on local broker disks. You can enable tiered storage when the selected plan and cloud support it.

Console

1. In the Aiven Console, open the project and select Services.
2. Click Create service.
3. Select Apache Kafka®.
4. In Service tier, select a supported tier.
5. In Cluster type, select Classic Kafka.
6. In Deployment mode, select Aiven cloud.
7. Select a cloud provider and region.
8. Select a plan.
9. Optional: Adjust Additional disk storage or enable Tiered storage, if supported for the selected plan and region.
10. In Service basics, enter:
    • Name: Name of the service. You cannot change the service name after creation.
    • Version: Select the Kafka version. The latest supported version appears by default.
    • Tags: Optional. Add resource tags to organize your services.
11. Review the Service summary, then click Create service.

CLI

Create a Classic Kafka service using Aiven CLI:

avn service create SERVICE_NAME \
  --project PROJECT_NAME \
  --service-type kafka \
  --cloud CLOUD_REGION \
  --plan PLAN_NAME

Parameters:

• SERVICE_NAME: Name of the Kafka service
• PROJECT_NAME: Project that contains the service
• CLOUD_REGION: Cloud provider and region
• PLAN_NAME: Classic Kafka plan

Terraform

Create a Classic Kafka service in your Aiven project using Terraform.

1. Create a file named provider.tf and add the following:

   Loading...

2. Create a file named service.tf and add the following:

   Loading...

3. Create a file named variables.tf and add the following:

   Loading...

4. Create the terraform.tfvars file and add the values for your token and project name.

5. Optional: To output connection details, create a file named output.tf and add the following:

   Loading...

To apply your Terraform configuration:

1. Initialize Terraform by running:

   terraform init

   The output is similar to the following:

   
   Initializing the backend...
   
   Initializing provider plugins...
   - Finding aiven/aiven versions matching ">= 4.0.0, < 5.0.0"...
   - Installing aiven/aiven v4.9.2...
   - Installed aiven/aiven v4.9.2
   ...
   Terraform has been successfully initialized!
   ...

2. To create an execution plan and preview the changes, run:

   terraform plan

3. To deploy your changes, run:

   terraform apply --auto-approve

Create a Classic Kafka service on Bring Your Own Cloud (BYOC)

Classic Kafka services on BYOC are available on the Professional service tier. The service runs in your own cloud account while Aiven manages the Kafka infrastructure and operations.

To create services on BYOC, first set up a BYOC environment. For instructions, see Create a custom cloud (BYOC).

Console

1. In the Aiven Console, open the project and select Services.
2. Click Create service.
3. Select Apache Kafka®.
4. In Service tier, select a supported tier.
5. In Cluster type, select Classic Kafka.
6. In Deployment mode, select Bring your own cloud (BYOC).
7. In the Cloud:
   • Select your BYOC environment.
   • Select a region.
8. Select a plan.
9. Optional: Adjust Additional disk storage or enable Tiered storage, if supported by the selected plan.
10. In Service basics, enter:
    • Name: Name of the service. You cannot change the service name after creation.
    • Version: Select the Kafka version. The latest supported version appears by default.
    • Tags: Optional. Add resource tags to organize your services.
11. Review the Service summary, then click Create service.

CLI

Create a Classic Kafka BYOC service using Aiven CLI:

avn service create SERVICE_NAME \
  --project PROJECT_NAME \
  --service-type kafka \
  --cloud CUSTOM_CLOUD_REGION \
  --plan PLAN_NAME

Parameters:

• SERVICE_NAME: Name of the Kafka service
• PROJECT_NAME: Aiven project name
• CUSTOM_CLOUD_REGION: BYOC region, such as custom-aws-eu-central-1
• PLAN_NAME: Classic Kafka BYOC plan

Related pages

• Create a Kafka topic
• Free tier overview
• Generate sample data in the console