Once you have tested your custom application locally, you can deploy it to the Power Platform controller. The application should be
placed in the /opt/plcnext/appshome/data folder on the controller. There are two ways to get the dep-ppl-app repository
with the application onto the controller.
Transfer the Application
Clone the repository directly on the controller using Git. The benefit of this approach is that any changes you make
to the repository can be pulled directly onto the controller using git pull.The controller needs access to the internet for this option.
SSH into the Controller
Open a terminal and connect to the controller via SSH:ssh admin@<controller-ip-address>
Navigate to the Target Folder
Navigate to the application data folder:cd /opt/plcnext/appshome/data
Clone the Repository
Clone your forked dep-ppl-app repository:git clone https://github.com/<your-username>/dep-ppl-app.git
Pull Updates (When Needed)
Whenever you push changes to your repository, you can pull them onto the controller:cd /opt/plcnext/appshome/data/dep-ppl-app
git pull
Use FileZilla to copy the entire dep-ppl-app repository folder to the controller.Open FileZilla
Open FileZilla (or another SFTP client) on your local machine.
Connect to Controller
Connect to the controller using:- Host:
controller_ip - Username:
admin - Password:
admin password - Port:
22
Navigate to Folders
- Navigate on the controller side to:
/opt/plcnext/appshome/data - Navigate on your local machine side to the folder containing the
dep-ppl-app repository.
Drag and Drop Repository
Drag and drop the dep-ppl-app folder from your local machine to the controller folder.
Verify File Transfer
Verify the file transfer was successful.
Install and Run the Application
Once the repository is on the controller, follow these steps to install and run the application.
Navigate to the Repository
SSH into the controller and navigate to the repository folder:cd /opt/plcnext/appshome/data/dep-ppl-app
Run the Install Script
Run the installation script. This will create a Python virtual environment, install all dependencies from
requirements.txt, and set up a cronjob that automatically starts the application when the controller reboots. Start the Application
Manually start the application by running: Stop the Application
To stop the application at any time, run: After running bash install.sh, the application will automatically start on every reboot of the controller thanks to
the cronjob. You can always manually start or stop the application using bash start.sh and bash stop.sh.
