English | 简体中文

space-agent, as the carrier of AO.space (open source version) all-in-one, mainly provides a unified entrance for AO.space server to start.

space-agent is responsible for binding AO.space server and client, launching AO.space microservices and unified management.

• Device Discovery and Binding
• Device Initialization
• Key Exchange
• Microservice Initiation and Management
• Decentralized Identity (DID) generation and management
• AO.space service upgrade and other functions

We will build a docker image of AO.space (Open Source) related services and make it available for download.

If you want to try to compile and build locally yourself

you can use our [Dockerfile](. /Dockerfile) to compile and build the container image

• docker (>=18.09)
• git
• golang 1.18 +

git clone [email protected]:ao-space/space-agent.git

go into project root directory , run this command

docker build -t local/space-agent:{tag} . 

The tag parameter can be modified to be consistent with the docker-compose.yml that is running on the server as a whole.

• X86_64
• Arm64

• Linux:
  • EulixOS/OpenEuler
  • Ubuntu
  • Others
• Windows
• MacOS

• Docker Engine >= 18.09
• Docker Desktop

• RAM： 4G
• CPU： 2 cores

You can also run AO.space (open source version) on some development boards such as Raspberry Pi etc.

After ensuring that docker is properly installed and running in your environment

To check if docker is running correctly you can use the following command:

docker version

$AOSPACE_HOME_DIR is the directory where you want the data to be stored

You can replace it yourself at startup

• Linux

DATADIR="$HOME/aospace"
sudo docker run -d --name aospace-all-in-one  \
        --restart always  \
        --network=ao-space  \
        --publish 5678:5678  \
        --publish 127.0.0.1:5680:5680  \
        -v $DATADIR:/aospace  \
        -v /var/run/docker.sock:/var/run/docker.sock:ro  \
        -e AOSPACE_DATADIR=$DATADIR \
        -e RUN_NETWORK_MODE="host"  \
        ghcr.io/ao-space/space-agent:latest

if you want to run ao.space on other os, refer to ao.space self-hosting doc

system-agent -version

To see if the aospace agent service is working, call the following interface.

/agent/status

{
  "status": "OK",
  "version": "dev"
}

modify /opt/tmp/system-agent.yml , change debugmode: false to debugmode: true ，and restart agent。

restart command

docker restart aospace-all-in-one

Open the swagger interface by accessing the address http://{your-host-ip}:5678/swagger/index.html in your computer's browser, where the ip address is the LAN address of your box.

Contributions to this project are very welcome. Here are some guidelines and suggestions to help you get involved in the project.

Contribution Guidelines

• Email: [email protected]
• Official Website
• Discussion group

Finally, thank you for your contribution to this project. We welcome contributions in all forms, including but not limited to code contributions, issue reports, feature requests, documentation writing, etc. We believe that with your help, this project will become more perfect and stronger.