Install Apps Manually
Last Updated: November 2021
Installing apps manually on an Azure VM is a similar process as described in Installing Apps in Production of the Manual Production Installation guide, but there are some differences. Use the following steps to install apps on an Azure VM:
1. Login as Tethys User
Remember, to use the tethys
command, you'll need to login as the tethys
user:
sudo su - tethys
2. Activate the Tethys Conda Environment
conda activate tethys
3. Change into the Apps Directory
A directory for app source code has already been created at $TETHYS_HOME/apps
.
cd $TETHYS_HOME/apps
4. Download App Source Code
Clone the app source code as suggested in the Download App Source Code section of Installing Apps in Production, using $TETHYS_HOME/apps
as the APP_SOURCES_ROOT
.
5. Install App
Install the app as suggested in the Install the App section of Installing Apps in Production, using $TETHYS_HOME/apps
as the APP_SOURCES_ROOT
.
6. Collect Static Files and Workspaces
It is not necessary to change permissions to collect static files or workspaces in the Azure VM image if you are logged in as the tethys
user. Simply run the following command after installing the app:
tethys manage collectall
7. Restart the Tethys Service
Restart the Tethys service for the new app to be loaded:
sudo systemctl restart tethys.service
8. Configure App Settings
Configure app settings in the Tethys Portal admin pages if required (see: Admin Pages > Tethys Apps).
9. Initialize Persistent Stores
If your app requires a database via the persistent stores API, you will need to initialize it:
tethys syncstores all