github.com/hellofresh/janus@v0.0.0-20230925145208-ce8de8183c67/docs/quick_start/README.md (about)

     1  # Quick Start
     2  
     3  1. [Download](#download)
     4  2. [Install](#install)
     5  3. [Run](#run)
     6  3. [Configure](#configure)
     7  
     8  ## Download
     9  
    10  You can get Janus for nearly any OS and architecture. You can get the latest Janus release on [Github](https://github.com/hellofresh/janus/releases).
    11  
    12  ## Install and run
    13  
    14  We highly recommend you to use one of our examples to start. Let's see the [front-proxy-mongo](https://github.com/hellofresh/janus/blob/master/examples/front-proxy-mongo) example:
    15  
    16  Make sure you have docker up and running on your platform and then run.
    17  
    18  ```sh
    19  docker-compose up -d
    20  ```
    21  
    22  This will spin up a janus server and will have a small proxy configuration that is going to a mock server that we spun up.
    23  
    24  ## Configure
    25  
    26  If you access `http://localhost:8080/example` you should see something like:
    27  
    28  ```json
    29  {
    30      "message": "Hello World!"
    31  }
    32  ```
    33  
    34  That means that Janus already proxied your request to an upstream. But of course you don't just want to do that. For this reason
    35  now is the perfect time for you to learn about all the available configurations that you can play with.
    36  
    37  > Note: If you are using the file-based configuration you will not be able to use the write administration API to add/modify/remove new endpoints, plugins, etc. Please check this [tutorial](file_system.md) if you'd like to add a new endpoint using the file-based configuration.
    38  
    39  Next, let's learn about how to [configure a new endpoint](authenticating.md).