github.com/avenga/couper@v1.12.2/docs/website/content/1.getting-started/2.running-couper.md (about)

     1  # Running Couper
     2  
     3  Couper is available as _docker
     4  image_ from [Docker Hub](https://hub.docker.com/r/avenga/couper)
     5  
     6  Running Couper requires a working [Docker](https://www.docker.com/) setup on your
     7  computer. Please visit the [get started guide](https://docs.docker.com/get-started/) to get prepared.
     8  
     9  To download/install Couper, open a terminal and execute:
    10  
    11  ```sh
    12  $ docker pull avenga/couper
    13  ```
    14  
    15  Couper needs a configuration file to know what to do.
    16  
    17  Create a directory with an empty `couper.hcl` file.
    18  
    19  Copy/paste the following configuration to the file and save it.
    20  
    21  ```hcl
    22  server "hello" {
    23    endpoint "/**" {
    24      response {
    25        body = "Hello World!"
    26      }
    27    }
    28  }
    29  ```
    30  
    31  Now `cd` into the directory with the configuration file and start Couper in a docker container:
    32  
    33  ```sh
    34  $ docker run --rm -p 8080:8080 -v "$(pwd)":/conf avenga/couper
    35  {"addr":"0.0.0.0:8080","level":"info","message":"couper gateway is serving","timestamp":"2020-08-27T16:39:18Z","type":"couper"}
    36  ```
    37  
    38  Now Couper is serving on your computer's port _8080_. Point your
    39  browser or `curl` to [`localhost:8080`](http://localhost:8080/) to see what's going on.
    40  
    41  Press <kbd>Ctrl</kbd> + <kbd>C</kbd> to stop the container.
    42  
    43  The [following section](/configuration/configuration-file) will give you an introduction into Couper's configuration file.
    44  
    45  If you prefer to learn about Couper by checking out certain features, visit the [example repository](https://github.com/avenga/couper-examples).