Simple ad-hoc server with SPA support based on Warp! Excellent for testing React, Angular, Vue apps and the like.
You can compile it yourself:
cargo install microserveror you can download the executable from Github releases and add it to your path.
No argument is mandatory so the current folder will be used as default if no path is specified
microserveryou can, of course, set the path of the folder you want to be served, by default in port 9090.
microserver ./path/to/foldermicroserver -h# by default microserver will use 0.0.0.0
microserver -a 127.0.0.1# by default microserver will use 9090 port
microserver -p 3000SPA support is enabled by default, meaning that if a resource is not found traffic will always be redirected to index.html.
If you want to opt-out of this behavior just use the --no-spa flag.
In the case you ever need to change the default spa index you can provide the --spa-index flag.
There are several ways to use microserver with a Docker image:
With a Dockerfile like the following:
# please omit the version if you just want the latest
FROM robertohuertasm/microserver:v0.1.6
# public being the location of your app files
COPY public/ /app/You can then run your SPA / static site using:
$ docker build -t my-service:local .
$ docker run -p 9090:9090 my-service:local
MicroServer running on port 9090!
Serving /app
Spa support: true. Root: index.htmlAlternatively, you could mount a volume with your content:
docker run -p 9090:9090 -v $(pwd)/public:/app robertohuertasm/microserver:v0.1.6More complex Dockerfile usage example with a multi-stage build of a React SPA:
FROM node:10.18-stretch-slim as builder
WORKDIR /app
COPY ./ /app
RUN yarn
RUN yarn build
FROM robertohuertasm/microserver:v0.1.6
COPY --from=builder /app/public /app/In this case whenever you run the microserver image, you'll have to be explicit about the arguments:
# don't forget to add "/app" as your final argument
docker run -p 9090:9090 -v $(pwd)/public:/app robertohuertasm/microserver:v0.1.6 "/microserver" "--no-spa" "/app"