Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.airys.chat/llms.txt

Use this file to discover all available pages before exploring further.

​
Deploying to Linux VM

This guide will help you install AirysChat on Ubuntu 24.04 LTS. We have prepared a deployment script for you to run. Refer to the script and feel free to make changes accordingly to the operating system if you are on a non-Ubuntu system.

​
Steps to install

If you plan to use a domain with airyschat, please add an A record before proceeding. Refer to the Configuring the installation domain section below.

​
1. Create an install.sh file

wget https://get.airyschat.app/linux/install.sh
chmod +x install.sh

​
2. Execute the script

The script will take care of the initial AirysChat setup. 
./install.sh --install

​
3. Access your installation

AirysChat Installation will now be accessible at http://{your_ip_address}:3000 or if you opted for domain setup, it will be at https://airyschat.mydomain.com.
This will also install the AirysChat CLI(cwctl) starting with AirysChat v2.7.0. Use cwctl --help to learn more.

​
Configuring The installation Domain

  1. Create an A record for airyschat.mydomain.com on your domain management system and point it towards the installation IP address.
  2. Continue with the installation script by entering yes when prompted about domain setup.
  3. Enter your domain. The script will take care of configuring Nginx and SSL via LetsEncrypt.
  4. Your AirysChat installation should be accessible from https://airyschat.mydomain.com now.

​
Configure the required environment variables

For your AirysChat installation to properly function, you would need to configure the essential environment variables like FRONTEND_URL, Mailer, and a cloud storage config. Refer Environment variables for the full list.

​
1. Login as airyschat user and edit the .env file

# Login as airyschat user
sudo -i -u airyschat
cd airyschat
nano .env

​
2. Update environment variables

Refer Environment variables and update the required variables. Save the .env file.

​
3. Restart the AirysChat server

If you have AirysChat CLI(cwctl) installed, use cwctl -r.
sudo systemctl restart airyschat.target

​
Upgrading to a newer version of AirysChat

Whenever a new version of AirysChat is released, use the following steps to upgrade your instance.
If you have AirysChat CLI(cwctl) installed, use cwctl --upgrade to upgrade your AirysChat installation.
To install cwctl, refer this section below.
If you are on an older version of AirysChat(< 2.7), follow the manual upgrade steps below if you face errors with cwctl.
Run the following steps on your VM. Make changes based on your OS if you are on a non-Ubuntu system. 
# Login as AirysChat user
sudo -i -u airyschat

# Navigate to the AirysChat directory
cd airyschat

# Pull the latest version of the master branch
git checkout master && git pull

# Ensure the ruby version is upto date
rvm install "ruby-3.3.3"
rvm use 3.3.3 --default

# Update dependencies
bundle
pnpm i

# Recompile the assets
rake assets:precompile RAILS_ENV=production

# Migrate the database schema
RAILS_ENV=production bundle exec rake db:migrate

# Switch back to root user
exit

# Copy the updated targets
cp /home/airyschat/airyschat/deployment/airyschat-web.1.service /etc/systemd/system/airyschat-web.1.service
cp /home/airyschat/airyschat/deployment/airyschat-worker.1.service /etc/systemd/system/airyschat-worker.1.service
cp /home/airyschat/airyschat/deployment/airyschat.target /etc/systemd/system/airyschat.target

# Reload systemd files
systemctl daemon-reload

# Restart the airyschat server
systemctl restart airyschat.target

​
Running Rails Console

If you have AirysChat CLI(cwctl) installed, use cwctl -c.
# Login as AirysChat user
sudo -i -u airyschat

# Navigate to the AirysChat directory
cd airyschat

# start rails console
RAILS_ENV=production bundle exec rails c

​
Viewing Logs

If you have AirysChat CLI(cwctl) installed, use cwctl -l web or cwctl -l worker.
Run the following commands in your ubuntu shell 
# logs from the rails server
journalctl -u airyschat-web.1.service -f

# logs from sidekiq
journalctl -u airyschat-worker.1.service -f

​
Install or Upgrade AirysChat CLI

If you used an older version of install script(< 2.0), you will not have cwctl in your PATH. To install/upgrade AirysChat CLI, 
wget https://get.airyschat.app/linux/install.sh -O /usr/local/bin/cwctl && chmod +x /usr/local/bin/cwctl
cwctl --help
The above command requires root access to install cwctl to /usr/local/bin.

​
Troubleshooting

​
If precompile fails

If the asset precompilation step fails with ActionView::Template::Error (Webpacker can't find application.css in /home/airyschat/airyschat/public/packs/manifest.json) or if you face issues while restarting the server, try the following command and restart the server. 
RAILS_ENV=production rake assets:clean assets:clobber assets:precompile
This command would clear the existing compiled assets and would recompile all the assets. Read more about it here