Skip to content


Switch branches/tags


Failed to load latest commit information.


Go Report Card Go.Dev reference Apache License

An API first development platform


Micro addresses the key requirements for building services in the cloud. It leverages the microservices architecture pattern and provides a set of services which act as the building blocks of a platform.

Micro deals with the complexity of distributed systems and provides simpler programmable abstractions to build on.


Below are the core components that make up Micro.


Micro is built as a microservices architecture and abstracts away the complexity of the underlying infrastructure. We compose this as a single logical server to the user but decompose that into the various building block primitives that can be plugged into any underlying system.

The server is composed of the following services.

  • API - HTTP Gateway which dynamically maps http/json requests to RPC using path based resolution
  • Auth - Authentication and authorization out of the box using jwt tokens and rule based access control.
  • Broker - Ephemeral pubsub messaging for asynchronous communication and distributing notifications
  • Config - Dynamic configuration and secrets management for service level config without the need to restart
  • Events - Event streaming with ordered messaging, replay from offsets and persistent storage
  • Network - Inter-service networking, isolation and routing plane for all internal request traffic
  • Proxy - An identity aware proxy used for remote access and any external grpc request traffic
  • Runtime - Service lifecycle and process management with support for source to running auto build
  • Registry - Centralised service discovery and API endpoint explorer with feature rich metadata
  • Store - Key-Value storage with TTL expiry and persistent crud to keep microservices stateless
  • Web - Simple web dashboard with dynamic forms to describe and query services in the browser


Micro additionally contains a built in Go framework for service development. The Go framework makes it drop dead simple to write your services without having to piece together lines and lines of boilerplate. Auto configured and initialised by default, just import and get started quickly.

Command Line

Micro brings not only a rich architectural model but a command line experience tailored for that need. The command line interface includes dynamic command mapping for all services running on the platform. Turns any service instantly into a CLI command along with flag parsing for inputs. Includes support for multiple environments and namespaces, automatic refreshing of auth credentials, creating and running services, status info and log streaming, plus much, much more.


Finally Micro bakes in the concept of Environments and multi-tenancy through Namespaces. Run your server locally for development and in the cloud for staging and production, seamlessly switch between them using the CLI commands micro env set [environment] and micro user set [namespace].


From Source

go install

Install Binaries


Using Scoop

scoop bucket add micro-cli
scoop install micro-cli

Using powershell

powershell -Command "iwr -useb | iex"


wget -q -O - | /bin/bash


curl -fsSL | /bin/bash

Run the server

micro server

Now go to localhost:8080 and make sure the output is something like {"version": "v3.10.1"} which is the latest version of micro installed.


Login to Micro

default username: admin

default password: micro

$ micro login
Enter username: admin
Enter password:
Successfully logged in.

See what's running:

$ micro services

View in browser at localhost:8082

Create a Service

Generate a service using the template

micro new helloworld

Run a service

Run from local dir

micro run .

Or from a git url

micro run

Check status of running service

$ micro status
helloworld	latest	running	n/a	4s ago	owner=admin, group=micro

View logs of the service to verify it's running.

$ micro logs helloworld
2020-10-06 17:52:21  file=service/service.go:195 level=info Starting [service] helloworld
2020-10-06 17:52:21  file=grpc/grpc.go:902 level=info Server [grpc] Listening on [::]:33975
2020-10-06 17:52:21  file=grpc/grpc.go:732 level=info Registry [service] Registering node: helloworld-67627b23-3336-4b92-a032-09d8d13ecf95

Call the service

$ micro helloworld call --name=Jane
	"msg": "Hello Jane"

Curl it

curl "http://localhost:8080/helloworld?name=John"

Write a service client

A service client is used within another service and must be run by micro

package main

import (

	proto ""

func main() {
	// create and initialise a new service
	srv := service.New()

	// create the proto client for helloworld
	client := proto.NewHelloworldService("helloworld", srv.Client())

	// call an endpoint on the service
	rsp, err := client.Call(context.Background(), &proto.CallRequest{
		Name: "John",
	if err != nil {
		fmt.Println("Error calling helloworld: ", err)

	// print the response
	fmt.Println("Response: ", rsp.Message)
	// let's delay the process for exiting for reasons you'll see below
	time.Sleep(time.Second * 5)

Run it

micro run .

Write an api client

An api client is an external app or client which makes requests through the micro api

Get a token

export TOKEN=`micro user token`

Call helloworld

package main

import (


type Request struct {
	Name string `json:"name"`

type Response struct {
	Msg string `json:"msg"`

func main() {
	token := os.Getenv("TOKEN")
	c := api.NewClient(nil)

	// set your api token

   	req := &Request{
		Name: "John",
	var rsp Response

	if err := c.Call("helloworld", "Call", req, &rsp); err != nil {

Run it

go run main.go

For more see the getting started guide.


  • Introduction - A high level introduction to Micro
  • Getting Started - The helloworld quickstart guide
  • Upgrade Guide - Update your go-micro project to use micro v3.
  • Architecture - Describes the architecture, design and tradeoffs
  • Reference - In-depth reference for Micro CLI and services
  • Resources - External resources and contributions
  • Roadmap - Stuff on our agenda over the long haul
  • FAQ - Frequently asked questions


See LICENSE which makes use of Apache 2.0.