Run a Go App

This quickstart assumes that you have:

Create a Go App

First, create a directory for the source code of your app, and navigate to it.

Terminal window
mkdir go-app && cd go-app

Next, create a go.mod file to enable dependency tracking of your code with:

Terminal window
go mod init github.com/deta/starters/go/hello-world

In your text editor, create a new file called main.go. Then, add the following code:

package main


import (
  "fmt"
  "log"
  "net/http"
  "os"
)


func main() {
  port := os.Getenv("PORT")
  if port == "" {
    port = "8080"
  }


  http.HandleFunc("/", handler)


  log.Printf("App listening on port %s!", port)
  if err := http.ListenAndServe(":"+port, nil); err != nil {
    log.Fatal(err)
  }
}


func handler(w http.ResponseWriter, r *http.Request) {
  fmt.Fprint(w, "Hello from Space! 🚀")
}

This code sets up a basic web server that listens on the port specified by the PORT environment variable.

💡 Make sure your app is configured to listen on the port defined by the PORT environment variable.

Create a Space Project

Space projects allow you to build, test, and use apps on Deta Space. They are also a (optional) launchpad for releasing them to the public.

To create a Space project, run the following command in the directory containing your source code:

Terminal window
space new

You will be prompted to enter a name for your project. The CLI will display a generated configuration for the app and prompt you to confirm.

Once confirmed, the project will be created along with a Spacefile. The Spacefile contains the configuration for your Micro and a .space directory that stores project information and links it to your Builder project.

# Spacefile Docs: https://go.deta.dev/docs/spacefile/v0
v: 0
micros:
  - name: go-app
    src: .
    engine: custom
    primary: true
    commands:
      - go build -o server
    include:
      - server
    run: ./server

⚠️ If the CLI fails to generate a configuration for your app, you can configure it manually. For more information, please refer to the Spacefile reference.

Developing Locally

You can run your app on your local machine, in a way that emulates Space for development. To do so, you need to define a startup command for your app’s development server using the dev command in the Spacefile.

# Spacefile Docs: https://go.deta.dev/docs/spacefile/v0
v: 0
micros:
  - name: go-app
    src: .
    engine: custom
    primary: true
    commands:
      - go build -o server
    include:
      - server
    run: ./server
   dev: go run .

Once you define the dev command for the Micro in the Spacefile, you can start the development server by running the following command:

space dev

Run it on Space

To deploy your app to Space, simply run:

space push

This will validate your Spacefile, package and upload your source code to the Space build pipeline, and stream logs of the whole process on your terminal. Once the build process is complete, your Builder Instance. Open it in your browser to test and use a live copy of your app on the internet.

💡 You can use space push --open to open the builder instance in your browser after successful deployment and update of the builder instance.

Congratulations! 🎉 You have successfully built, deployed and got your first Go app on Space. 🚀