Publish the new version ✈️ | Look description please!

# FAQ

### Looking for free support?

	http://support.iris-go.com
    https://kataras.rocket.chat/channel/iris

### Looking for previous versions?

    https://github.com/kataras/iris#version

### Should I upgrade my Iris?

Developers are not forced to upgrade if they don't really need it. Upgrade whenever you feel ready.
> Iris uses the [vendor directory](https://docs.google.com/document/d/1Bz5-UB7g2uPBdOx-rw5t9MxJwkfpx90cqG9AFL0JAYo) feature, so you get truly reproducible builds, as this method guards against upstream renames and deletes.

**How to upgrade**: Open your command-line and execute this command: `go get -u github.com/kataras/iris`.
For further installation support, please click [here](http://support.iris-go.com/d/16-how-to-install-iris-web-framework).

### About our new home page
    http://iris-go.com

Thanks to [Santosh Anand](https://github.com/santoshanand) the http://iris-go.com has been upgraded and it's really awesome!

[Santosh](https://github.com/santoshanand) is a freelancer, he has a great knowledge of nodejs and express js, Android, iOS, React Native, Vue.js etc, if you need a developer to find or create a solution for your problem or task, please contact with him.

The amount of the next two or three donations you'll send they will be immediately transferred to his own account balance, so be generous please!

Read more at https://github.com/kataras/iris/blob/master/HISTORY.md


Former-commit-id: eec2d71bbe011d6b48d2526eb25919e36e5ad94e

_examples/intermediate/custom-httpserver/iris-way/main.go

@@ -0,0 +1,31 @@
+package main
+
+import (
+	"net/http"
+
+	"github.com/kataras/iris"
+	"github.com/kataras/iris/context"
+)
+
+func main() {
+	app := iris.New()
+
+	app.Get("/", func(ctx context.Context) {
+		ctx.Writef("Hello from the server")
+	})
+
+	app.Get("/mypath", func(ctx context.Context) {
+		ctx.Writef("Hello from %s", ctx.Path())
+	})
+
+	srv := &http.Server{Addr: ":8080" /* Any custom fields here: Handler and ErrorLog are setted to the server automatically */}
+	// http://localhost:8080/
+	// http://localhost:8080/mypath
+	app.Run(iris.Server(srv)) // same as app.Run(iris.Addr(":8080"))
+
+	// More:
+	// see "multi" if you need to use more than one server at the same app.
+	//
+	// for a custom listener use: iris.Listener(net.Listener) or
+	// iris.TLS(cert,key) or iris.AutoTLS(), see "custom-listener" example for those.
+}

_examples/intermediate/custom-httpserver/main.go

@@ -1,33 +0,0 @@
-package main
-
-import (
-	"net/http"
-
-	"gopkg.in/kataras/iris.v6"
-	"gopkg.in/kataras/iris.v6/adaptors/httprouter"
-)
-
-func main() {
-	app := iris.New()
-	// output startup banner and error logs on os.Stdout
-	app.Adapt(iris.DevLogger())
-	// set the router, you can choose gorillamux too
-	app.Adapt(httprouter.New())
-
-	app.Get("/", func(ctx *iris.Context) {
-		ctx.Writef("Hello from the server")
-	})
-
-	app.Get("/mypath", func(ctx *iris.Context) {
-		ctx.Writef("Hello from %s", ctx.Path())
-	})
-
-	// call .Boot before use the 'app' as an http.Handler on a custom http.Server
-	app.Boot()
-
-	// create our custom fasthttp server and assign the Handler/Router
-	fsrv := &http.Server{Handler: app, Addr: ":8080"}
-	fsrv.ListenAndServe()
-
-	// navigate to http://127.0.0.1:8080/mypath
-}

_examples/intermediate/custom-httpserver/multi/main.go

@@ -0,0 +1,48 @@
+package main
+
+import (
+	"net/http"
+
+	"github.com/kataras/iris"
+	"github.com/kataras/iris/context"
+)
+
+func main() {
+	app := iris.New()
+
+	app.Get("/", func(ctx context.Context) {
+		ctx.Writef("Hello from the server")
+	})
+
+	app.Get("/mypath", func(ctx context.Context) {
+		ctx.Writef("Hello from %s", ctx.Path())
+	})
+
+	// Note: It's not needed if the first action is "go app.Run".
+	if err := app.Build(); err != nil {
+		panic(err)
+	}
+
+	// start a secondary server listening on localhost:9090.
+	// use "go" keyword for Listen functions if you need to use more than one server at the same app.
+	//
+	// http://localhost:9090/
+	// http://localhost:9090/mypath
+	srv1 := &http.Server{Addr: ":9090", Handler: app}
+	go srv1.ListenAndServe()
+	println("Start a server listening on http://localhost:9090")
+
+	// start a "second-secondary" server listening on localhost:5050.
+	//
+	// http://localhost:5050/
+	// http://localhost:5050/mypath
+	srv2 := &http.Server{Addr: ":5050", Handler: app}
+	go srv2.ListenAndServe()
+	println("Start a server listening on http://localhost:5050")
+
+	// Note: app.Run is totally optional, we have already built the app with app.Build,
+	// you can just make a new http.Server instead.
+	// http://localhost:8080/
+	// http://localhost:8080/mypath
+	app.Run(iris.Addr(":8080")) // Block here.
+}

_examples/intermediate/custom-httpserver/std-way/main.go

@@ -0,0 +1,43 @@
+package main
+
+import (
+	"net/http"
+
+	"github.com/kataras/iris"
+	"github.com/kataras/iris/context"
+)
+
+func main() {
+	app := iris.New()
+
+	app.Get("/", func(ctx context.Context) {
+		ctx.Writef("Hello from the server")
+	})
+
+	app.Get("/mypath", func(ctx context.Context) {
+		ctx.Writef("Hello from %s", ctx.Path())
+	})
+
+	// call .Build before use the 'app' as an http.Handler on a custom http.Server
+	if err := app.Build(); err != nil {
+		panic(err)
+	}
+
+	// create our custom server and assign the Handler/Router
+	srv := &http.Server{Handler: app, Addr: ":8080"} // you have to set Handler:app and Addr, see "iris-way" which does this automatically.
+	// http://localhost:8080/
+	// http://localhost:8080/mypath
+	println("Start a server listening on http://localhost:8080")
+	srv.ListenAndServe() // same as app.Run(iris.Addr(":8080"))
+
+	// Notes:
+	// Banne and Tray are not shown at all. Same for the Interrupt Handler, even if app's configuration allows them.
+	//
+	// `.Run` is the only one function that cares about those three.
+
+	// More:
+	// see "multi" if you need to use more than one server at the same app.
+	//
+	// for a custom listener use: iris.Listener(net.Listener) or
+	// iris.TLS(cert,key) or iris.AutoTLS(), see "custom-listener" example for those.
+}