Repository files navigation

A web-based GUI for your AWS or LocalStack development environment.

Contributions and feature requests are welcome!

• AWS S3

  • Create, view and delete buckets
  • View, delete, upload and download objects

• AWS SQS

  • Create, view and delete queues
  • Send, receive and peek messages
  • Import Protobuf definitions and send Protobuf-formatted messages

• AWS SNS

  • Create, view and delete topics
  • Create, view and delete subscriptions (only SQS subscriptions can be created at the moment)
  • Send messages to topics

Also see thechecklist of upcoming features.

Download precompiled executables fromReleases, or pull the latestDocker image.

• ASP.NET Core Runtime for .NET 6.0 or newer (Download)
• Any operating system supported by the above runtime

To run GuiStack, execute therun.bat script included within the release.

Prior to running GuiStack, you have to give the GuiStack executable and the accompanyingrun.sh scriptexecute permissions:

$ chmod +x ./GuiStack ./run.sh

Then you should be able to executerun.sh to start GuiStack.

Download thedefault-run-docker.sh script from the repository and execute it to start the Docker container.

GuiStack can be configured by setting various environment variables before starting the application. Most of them are provided in therun.sh orrun.bat file included within the release (or indefault-run-docker.sh, if using the Docker image).

By default, GuiStack can be accessed viahttps://localhost:5001. To configure which port GuiStack should listen to, edit the accompanyingappsettings.json file and add a property called"Urls":

{"Logging": {"LogLevel": {"Default":"Information","Microsoft":"Warning","Microsoft.Hosting.Lifetime":"Information"    }  },"AllowedHosts":"*","Urls":"https://localhost:5005"}

Indefault-run-docker.sh, the Docker container is configured to map the internal listening port (port 80) tohttp://localhost:5000. To change the port, modify the following line indefault-run-docker.sh:

docker run -p 5000:80 \

Requires:

• .NET 6.0 SDK or newer (Download)
• Git Bash (if building on Windows) (Download)

Optional:

• Visual Studio 2022

To build GuiStack, simply execute one of thebuild-*.sh scripts for the platform you wish to build for, located in the root of this repository.