This repository is intentionally kept minimal and simple. It's designed to help you get your first experience with Gno in under five minutes, focusing on the most common tools and basic concepts.
If you're already familiar with Gno or looking for a more comprehensive setup, check out the "Next Steps" section below for links to more advanced resources.
-
Clone this repository:
git clone https://github.com/gnolang/getting-started.git cd getting-started -
Install dependencies:
make install
This clones gnolang/gno and builds gno, gnokey, gnodev, gnobro and
gnoweb into $HOME/.gno/bin. It needs Go, git and make, and takes a few
minutes the first time. Add the directory to your PATH before continuing:
export PATH="$HOME/.gno/bin:$PATH"
(The installer also has a faster prebuilt-binary mode, but it currently looks
for v* release tags and gnolang/gno only publishes chain/* tags, so
--from-source is the path that works today.)
-
Start the development server:
make dev -
Open your browser and visit http://localhost:8888
This repository contains a simple Gno realm with:
- A
Renderfunction that displays a welcome message and instructions - A
Setfunction to update the realm's state - A
Getfunction to retrieve the stored message
gnodev runs a throwaway local chain. When you want your realm on a real
network:
- A testnet — start here. Testnets are renamed and replaced every few weeks, so look up the current one and its RPC endpoint in Gno networks, and get tokens from the faucet.
- Mainnet (
gnoland-1,https://rpc.gno.land:443) has been live since 12 September 2026. Real GNOT, no faucet.
Ready to learn more? Check out these resources:
- Gno Documentation: https://docs.gno.land
- Gno Repository Template: https://github.com/gnolang/repo-template