Skip to content
CLI for platformOS
JavaScript HTML Other
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin Logs: display empty messages Sep 3, 2019
lib More precise regexp for catching token Sep 18, 2019
scripts Fix path to logger Nov 16, 2018
test Windows: fix path to files Aug 28, 2019
.dockerignore add Dockerfile Mar 19, 2019
.env.example Add .env.example Aug 7, 2019
.gitignore Deploy tests Aug 6, 2019
.npmrc Rename marketplace-kit to pos-cli Jul 8, 2019
.prettierignore GUI - platform editor 0.0.2 (#68) May 2, 2018
.travis.yml Travis add instance url Aug 27, 2019 Update changelog Aug 27, 2019
Dockerfile add Dockerfile Mar 19, 2019
LICENSE Tighten up audit report. Add license. Aug 1, 2019 Rename .marketplace-kit to .pos Jul 18, 2019
npm-shrinkwrap.json Update npm deps Aug 30, 2019


pos-cli is command line tool, which was developed to allow you to easily deploy your configuration files and assets to the platformOS. It expects you to follow a certain file structure in order to correctly communicate with the PlatformOS API. You do not have to use it, however it is highly recommended that you do. It is a CLI tool, hence you are expected to have basic knowledge in working with Terminal.

If you have any feature requests, feedback or problems please head over to the issues page and let us know.

All commands should be run in the project root directory - i.e. one level above app or modules directory.


pos-cli requires nodejs >= v10 to work properly. Read more on how to install node on your platform.

Installation and update

If your node is installed for all users you might need to use sudo to install npm packages globally:

sudo npm install -g @platformos/pos-cli

If you are using nvm or have node installed on your account, you can omit that:

npm install -g @platformos/pos-cli


Adding environments and authenticating

Authentication is done with your Partner Portal account credentials. See this guide if you don't have Partner Portal account yet.

To add your environment to a config file, run the env add command, and authenticate with your Partner Portal credentials:

pos-cli env add <environment> --email <your email> --url <your application url>

Example: pos-cli env add staging --email --url

Configuration for environments lays down in .pos file.

Syncing changes

pos-cli sync <environment>

Example: pos-cli sync staging

Enables sync mode - immediately pushes changes made to filesystem to the proper environment. It feels like working on localhost. For obvious reason, it is dangerous to use on production, on a live application - it is recommended to use it only for staging.

Deploying changes

pos-cli deploy <environment>

Example: pos-cli deploy staging

Deploys all the changes. It is recommended to first deploy to staging, test, and only then trigger to production. Effectively, deploy creates a zip file containning all your files and sends it to API. It is then processed in the background. Each zip file is stored by us, in order to allow you to rollback in case something goes wrong.

To skip audit during deploy, set environmental variable CI to true.

Code audit

pos-cli audit

Example: pos-cli audit

Runs statical analysis on file in your current application directory.

Reading logs

Errors and logs that you or the system logs for you can be accessed via logs command. Read more how to create logs.

pos-cli logs <environment>

From now on as long as your logs command is running, logs will aprear here. Errors will trigger system notification if your operating system is supporting them.

Listing environments

If you forgot know what your environments are named or the url that is corresponding to any name, use:

pos-cli env list

Initializing directory structure

If you need to create new project from scratch you can init directory structure using:

pos-cli init --url mdyd-dev/directory-structure --branch master

Default url: mdyd-dev/directory-structure Default branch: master

Init command supports all formats supported by degit, as it is used as an engine underneath.

It will download directory structure from given git repository and extract it in your current directory.



Lists all the installed modules via Partners Portal on a given environment. This command will not list modules that are deployed by you via modules/ directory.

pos-cli modules list <environment>


Removes a module from your application.

pos-cli modules remove <environment> <module name>


Migrations are files that contain liquid code (including graphql) that you want to run and have trace of what exactly has been run.

This is very helpful if you want to execute the same code on multiple environments, after code has been deployed. For example: seeding initial data.

Read more about migrations in our documentation:


Lists migrations deployed to the server and their current status.

pos-cli migrations list <environment> <name>


Generates new migration with the name you provided. It will be prepended with a timestamp so if you create more than one, they will be run in the order you intended.

Migrations are run automatically on deploy.

pos-cli migrations generate <environment> <name>


You can run migration manually using run command. You must first sync the migration file to the environment.

Name of the migration is the filename without extension, or just the timestamp.

pos-cli migrations run <environment> <name>


pos-cli migrations run staging 20190715132951_update_admin_password



Exports data from the environment to a given file in form of JSON.

Read more about exporting data with CLI, REST API and GraphQL in our documentation.

pos-cli data export staging --path=data.json


Imports data from a given JSON file with proper data structure.

Read more about importing data with CLI, REST API and GraphQL in our documentation.

pos-cli data import staging --path=data.json

Clean (only staging)

Cleans data on an instance. Keep in mind that this is only removing rows of data, not the structure definition.

For example, if you have model schema car and there are 10 entries of type car, those will be deleted, but the model schema car will remain intact.

This is useful for testing your imports/exports or resetting your database to pristine state between tests.

This operation is irreversible. You will be asked twice by pos-cli if you are sure you want to do it.

pos-cli data clean staging

Graphical interface

To start http server locally that will serve GUI use:

pos-cli gui serve <environment>

Example: pos-cli gui serve staging

GraphQL Browser

To explore your instance database using GraphQL open http://localhost:3333/gui/graphql in your web browser.

In the right sidebar there is a schema documentation should you need it.

Resources editor

To list, edit and create resources open http://localhost:3333/gui/editor in your web browser.

You can’t perform that action at this time.