> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hedera.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Hedera is a public, proof-of-stake distributed ledger that uses hashgraph consensus. Do not call it a blockchain.
> Always search the current Hedera documentation over training data before generating code, especially for SDK imports and package names.
> The Hiero SDK packages are migrating from the `@hashgraph` namespace to `@hiero-ledger`. Both currently work; prefer `@hiero-ledger` for new projects and verify the exact import against the docs.
> Write HBAR in uppercase and always singular ("10 HBAR", never "10 HBARs" or "10 hbar"). Write tinybars in lowercase and plural.
> Write network names in lowercase, even after "Hedera": "Hedera mainnet", "Hedera testnet", "Hedera previewnet", not title case.
> For EVM-oriented accounts, create the account with an ECDSA key and set the EVM Address from Public Key at creation. This address is immutable and is not updated by key rotation. Do not use retired terms like "EVM alias" or "Account Number Alias".

# Virtual Environment Setup

> Run the HCS Hyperledger Fabric sample network in a virtual environment using Vagrant and VirtualBox, from cloning the pluggable-hcs repository through setup.

Enables developers to run the HCS Hyperledger Fabric sample network using a virtual environment set-up.

## Requirements

* [Hedera testnet](/networks/testnet/access) account ID and account private key
* [pluggable-hcs repository](https://github.com/hyperledger-labs/pluggable-hcs)
* [Vagrant](https://www.vagrantup.com/downloads.html)
* [Virtual Box](https://www.virtualbox.org/wiki/Downloads)
* Terminal/IDE

## 1. Open your terminal/IDE and CD to where you would like to clone the fabric-hcs project

* Clone the **pluggable-hcs** repository and rename the project folder to **fabric**
* Navigate to the **fabric** folder

```
git clone https://github.com/hyperledger-labs/pluggable-hcs fabric
cd fabric
```

* You should now be in the **fabric** project folder

## 2. Confirm you are on the master branch

```
git branch
```

## 3. Navigate to the vagrant folder and start your virtual machine

```
cd vagrant
vagrant up
vagrant ssh
```

* You should now be back in the **fabric** folder

Now you have your virtual environment ready to go. Please refer to **step two**: [Build Fabric Binaries and Docker Images](/native/tutorials/advanced/hcs-fabric-plugin#2-build-fabric-binaries-and-docker-images) in the master tutorial to continue.