Device Provisioning
Devices in Synpse are responsible for running your applications.
Devices in Synpse are like virtual machines in your favourite cloud provider. You will need at least one device that is online to run your applications. There's no limit on the number of applications that can be started on a single device, it depends on the available CPU and RAM.
Once device is registered to a project, you will be able to:
- SSH into the device
- Deploy applications to the device
- View device resource (CPU/RAM/Disk) utilization
All projects are created with a default registration token. However, it's often required to create new registration tokens with specific limits or just with new environment variables or labels. To create a new token, go to the "provisioning" page and click on "create registration token":

Once the device registration token is created, click "Provision Device" and select the token:

This command will:
- 1.Download the synpse agent to the device
- 2.Install it and supply the registration details
Once you run the command, you should be able to see the device in your devices page:

registered device view
In cases where systemd is not available or other type of process supervisor is used manual agent configuration might be needed.
Synpse agent when starting will look for configuration file
config.yaml
in default location /etc/synpse
(can be changed using AGENT_CONFIG_DIR
variable).Config file example:
---
agent:
controllerURI: http://cloud.synpse.com/api
project: prj_1u4dQL6qYFGMkhmcKJPt93gYUUU
registrationToken: drt_1u4dQMx57tzIo7K62gKqve4HHHH
Download latest agent:
curl https://downloads.synpse.net/agent/linux/amd64/latest/agent -o /usr/local/bin/synpse-agent
Last modified 1yr ago