Artica Wiki

Create or remove a new syncthing Instance using REST API

Artica can automatically provision and manage multiple Syncthing instances by leveraging each Linux username and a dedicated instance name

Artica can automatically provision and manage multiple Syncthing instances by leveraging each Linux username and a dedicated instance name. 
For every user, Artica creates a separate Syncthing “home” directory, assigns a unique GUI/API port and sync port. 
Likewise, if you need a second instance for the same user, Artica uses a different instance name (e.g. alice-backup) to spin up another service, another config path, and a distinct set of ports. 
In this way, each combination of username and instance name operates in isolation—each instance has its own configuration, API key, and data folders—while Artica handles all of the service‐unit creation, port assignment, and startup scripts automatically.

Create Instance by command-line:

artica-phpfpm-service -create-syncthing -instance alice -user alice

will create the user alice ( is not exists ), the  folder in /home/alice and install necessaries syncthing installs for this instance
 

Create Instance Using REST API:

GET http://1.2.3.4:9503/syncthing/instances/create/[instancename]/[username]

Example: curl http://1.2.3.4:9503/syncthing/instances/create/alice/alice

Remove an instance by command-line:

artica-phpfpm-service -remove-syncthing -instance alice -user alice

will remove processes but keep files /home/alice 
 

Remove an instance Using REST API:

GET http://1.2.3.4:9503/syncthing/instances/remove/[instancename]/[username]

Example: curl http://1.2.3.4:9503/syncthing/instances/remove/alice/alice