Getting Started
Using the CLI

Using the CLI

The runtipi-cli is a command line tool that allows you to start, stop, restart, update, and manage tipi from the command line.


./runtipi-cli command options

Start Command

To start tipi run the following command:

sudo ./runtipi-cli start

Tipi is run as root in the examples because during the start process it needs to check and eventually change the permissions of some files in the runtipi folder. You can run the command without sudo if needed but you may encounter permission issues.

Stop Command

To stop tipi run the following command:

sudo ./runtipi-cli stop

Restart Command

To restart tipi from the command line run this command:

sudo ./runtipi-cli restart


This command updates tipi to the latest version available.

You can update to the latest version with this command:

sudo ./runtipi-cli update latest

If you want to update to a specific version you give the version number as an argument:

sudo ./runtipi-cli update v2.0.7

You can downgrade Tipi to a previous version by running the update command with the version you want to downgrade to. However, this is highly discouraged as it may lead to breaking your install. Make sure you know what you are doing.

Reset password command

This command is used to reset a forgotten admin password.

To reset your password run the following command and visit the tipi rest page at http://<your-ip>/reset-password it should prompt you to enter your new password.

./runtipi-cli reset-password

App management command

This command can be used to start and stop apps from the cli.

./runtipi-cli app [command] <app>

Example: Start the code-server app

./runtipi-cli app start code-server

Example: Stop the code-server app

./runtipi-cli app stop code-server

Debug command

This command is used to display useful information about the tipi installation. It can be used to troubleshoot issues.

To use this command just run this:

./runtipi-cli debug

Help command

This command is used to display help for an other command in runtipi cli.

To use this command just run this:

./runtipi-cli help start

This will display the help for the start command.