# Running express-gateway locally
It is sometimes required to play with the API gateway on your local development environment for debug purpose. As Kargo relies on a specific image built with plugins, etc. you can use it but it might not be so convenient. Otherwise you can clone express-gateway (opens new window) and do the following to run it locally with e.g. the S3 plugin:
Add AWS SDK dependency to the
Copy the Kargo plugin into the
Add S3 plugin at the end of the
plugins: s3: package: ./s3
- Add S3 endpoint/pipeline the
apiEndpoints: s3: hosts: '*' paths: '/s3/*' serviceEndpoints: s3: url: 'http://localhost:9876/s3' pipelines: s3: apiEndpoints: - s3 policies: - proxy: - action: serviceEndpoint: s3 changeOrigin: true stripPath: true
Configure the required environment variables (
S3_ENDPOINT) then launch the gateway:
npm run start:dev.
Now you should be able to access objects using the following URL: http://localhost:9876/s3/bucket/key.