1
0
mirror of synced 2025-12-19 18:10:59 -05:00
Files
docs/content/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-openstack-kvm.md
Rachael Sewell 9d4d6dc4b0 Deprecate ghes 3.10 (#54410)
Co-authored-by: Kevin Heis <heiskr@users.noreply.github.com>
2025-02-18 18:37:25 +00:00

4.1 KiB

title, intro, redirect_from, versions, type, topics, shortTitle
title intro redirect_from versions type topics shortTitle
Installing GitHub Enterprise Server on OpenStack KVM To install {% data variables.product.prodname_ghe_server %} on OpenStack KVM, you must have OpenStack access and download the {% data variables.product.prodname_ghe_server %} QCOW2 image.
/enterprise/admin/guides/installation/installing-github-enterprise-on-openstack-kvm
/enterprise/admin/installation/installing-github-enterprise-server-on-openstack-kvm
/admin/installation/installing-github-enterprise-server-on-openstack-kvm
/admin/installation/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-openstack-kvm
ghes
*
tutorial
Administrator
Enterprise
Infrastructure
Set up
Install on OpenStack

Prerequisites

  • {% data reusables.enterprise_installation.software-license %}
  • You must have access to an installation of OpenStack Horizon, the web-based user interface to OpenStack services. For more information, see the Horizon documentation.

Hardware considerations

{% data reusables.enterprise_installation.hardware-considerations-all-platforms %}

Downloading the {% data variables.product.prodname_ghe_server %} image

{% data reusables.enterprise_installation.download-license %} {% data reusables.enterprise_installation.download-appliance %}

  1. Under "{% data variables.product.prodname_dotcom %} On-premises", select the "Select your hypervisor" dropdown menu and click OpenStack KVM (QCOW2).
  2. Click Download for OpenStack KVM (QCOW2).

Creating the {% data variables.product.prodname_ghe_server %} instance

{% data reusables.enterprise_installation.create-ghe-instance %}

  1. In OpenStack Horizon, upload the {% data variables.product.prodname_ghe_server %} image you downloaded. For instructions, see the "Upload an image" section of the OpenStack guide Upload and manage images. {% data reusables.enterprise_installation.create-attached-storage-volume %} For instructions, see the OpenStack guide Create and manage volumes.

  2. Create a security group, and add a new security group rule for each port in the table below. For instructions, see the OpenStack guide Configure access and security for instances.

    {% data reusables.enterprise_installation.necessary_ports %}

  3. Optionally, associate a floating IP to the instance. Depending on your OpenStack setup, you may need to allocate a floating IP to the project and associate it to the instance. Contact your system administrator to determine if this is the case for you. For more information, see Allocate a floating IP address to an instance in the OpenStack documentation.

  4. Launch {% data variables.location.product_location %} using the image, data volume, and security group created in the previous steps. For instructions, see the OpenStack guide Launch and manage instances.

Configuring the {% data variables.product.prodname_ghe_server %} instance

{% data reusables.enterprise_installation.new-instance-config-summary %}

{% data reusables.enterprise_installation.new-instance-attack-vector-warning %}

{% data reusables.enterprise_installation.copy-the-vm-public-dns-name %} {% data reusables.enterprise_installation.upload-a-license-file %} {% data reusables.enterprise_installation.save-settings-in-web-based-mgmt-console %} For more information, see AUTOTITLE. {% data reusables.enterprise_installation.instance-will-restart-automatically %} {% data reusables.enterprise_installation.visit-your-instance %}

Further reading