Skip to main content

​
Getting Started with Go Hosting

Deploy your Go applications on ShardCloud with minimal configuration and maximum performance.
ShardCloud supports Go applications with automatic module resolution and dependency management.

​
Prerequisites

Before uploading your Go application, ensure you have the following project structure ready.

Required Files

Essential files for deployment

Simple Structure

Clean deployment process

​
Required Files

Your Go application must include these three essential files:

​
1. Entry Point File

  • File: main.go or your main Go file
  • Purpose: Main application entry point with main() function
  • Requirements: Must contain your application’s main execution code

​
2. Module Configuration

  • File: go.mod
  • Purpose: Defines Go module and dependencies
  • Requirements: Valid Go module file with module name and dependency versions

​
3. ShardCloud Configuration

  • File: .shardcloud
  • Purpose: Platform-specific deployment settings
  • Requirements: Plain text configuration file in root directory
All three files are mandatory. Missing any of these files will prevent successful deployment.

​
ShardCloud Configuration

The .shardcloud file configures your application deployment settings.

​
Configuration Example

DISPLAY_NAME=myfirstgoproject
DESCRIPTION=a simple go application
MAIN=main.go
MEMORY=512
VERSION=LATEST
Go applications are typically memory-efficient. Choose the minimum required memory for optimal performance.

​
Deployment Process

1

Initialize Module

Ensure go.mod is properly configured with all dependencies
2

Prepare Entry Point

Verify your main Go file contains the main() function
3

Configure Platform

Create .shardcloud file with deployment settings
4

Create Archive

Zip or RAR your project
5

Upload via Dashboard

Use ShardCloud dashboard to upload your archive
6

Deploy & Monitor

Application automatically builds and deploys

​
Common Configuration Examples

​
Gin Web Server

DISPLAY_NAME=gin-api
DESCRIPTION=REST API with Gin framework
MAIN=server.go
MEMORY=512
VERSION=LATEST
SUBDOMAIN=ginapi
⌘I