Skip to main content
Version: User Docs

Quick Start for Nacos

This topic is about how to set up and use Nacos.

0.Choose Version

You can see the introduction of each version at release notes or blog, the current recommended version is 2.2.3.

1.Prerequisites

Before you begin, install the following:

  1. 64bit OS: Linux/Unix/Mac/Windows supported, Linux/Unix/Mac recommended.
  2. 64bit JDK 1.8+: downloads, JAVA_HOME settings.
  3. Maven 3.2.x+: downloads, settings.

2.Download & Build from Release

There are two ways to get Nacos.

1)Download source code from Github

git clone https://github.com/alibaba/nacos.git
cd nacos/
mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U
ls -al distribution/target/

// change the $version to your actual path
cd distribution/target/nacos-server-$version/nacos/bin

2)Download run package

Select the latest stable version from https://github.com/alibaba/nacos/releases

  unzip nacos-server-$version.zip  OR tar -xvf nacos-server-$version.tar.gz
cd nacos/bin

3.Setting Configuration

Must do this setting in 2.2.0.1 and 2.2.1, otherwise fail to start.

Setting configuration file application.properties under conf.

Setting nacos.core.auth.plugin.nacos.token.secret.key parameter,detail see Authentication-Custom SecretKey.

Attention,Default value in Document SecretKey012345678901234567890123456789012345678901234567890123456789 and VGhpc0lzTXlDdXN0b21TZWNyZXRLZXkwMTIzNDU2Nzg= is a public default, only should use in test temporary. Please make sure to replace it with another valid value when you actually deploy.

4.Start Server

Linux/Unix/Mac

Run the following command to start(standalone means non-cluster mode):

sh startup.sh -m standalone

If you are using a ubuntu system, or encounter this error message [[symbol not found, try running as follows:

bash startup.sh -m standalone

Windows

Run the following command to start(standalone means non-cluster mode):

cmd startup.cmd -m standalone

5.Service & Configuration Management

Service registration

curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=nacos.naming.serviceName&ip=20.18.7.10&port=8080'

Service discovery

curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'

Publish config

curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=helloWorld"

Get config

curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test"

6.Shutdown Servers

Linux/Unix/Mac

sh shutdown.sh

Windows

cmd shutdown.cmd

Or click the shutdown.cmd file operation.