#spa #server #cli #simple

app microserver

Simple ad-hoc server with SPA support based on Warp! Excellent for testing React, Angular, Vue apps and the like

11 releases

0.2.1 Apr 12, 2022
0.2.0 Nov 23, 2020
0.1.8 Aug 17, 2020
0.1.7 Jan 27, 2020
0.1.2 Oct 28, 2018

#440 in HTTP server

Download history 2/week @ 2024-02-14 11/week @ 2024-02-21 7/week @ 2024-02-28 2/week @ 2024-03-13 23/week @ 2024-03-27 44/week @ 2024-04-03

67 downloads per month

MIT license

106 lines


Actions Status Crates.io Docker Build Docker Pulls

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 microserver

or 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


you can, of course, set the path of the folder you want to be served, by default in port 9090.

microserver ./path/to/folder

Need help?

microserver -h

Changing the address

# by default microserver will use
microserver -a

Changing the port

# by default microserver will use 9090 port
microserver -p 3000

SPA support

SPA 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.html

Alternatively, you could mount a volume with your content:

docker run -p 9090:9090 -v $(pwd)/public:/app robertohuertasm/microserver:v0.1.6

More complex Dockerfile usage example with a multi-stage build of a React SPA:

FROM node:10.18-stretch-slim as builder
COPY ./ /app
RUN yarn
RUN yarn build

FROM robertohuertasm/microserver:v0.1.6
COPY --from=builder /app/public /app/

If you don't want the default arguments

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"


~258K SLoC