Cookies ahead

Our support chat tool "Intercom" would like to collect some more data on you. See the related link for more details.

Docs

SSH access

Reviewed

Markdown ↓

🔑

Secure shell access.

Connect to your fortrabbit app's remote environment via SSH for secure command-line access to execute PHP scripts, run Composer, and manage your code.

Get ready

Accessing SSH

Each environment has its own SSH access. Execute the following in your terminal to login:

# Connect to your environment via SSH
$ ssh {{app-env-id}}@ssh.{{region}}.frbit.app
shell

If the login went well, you will see a small welcome message:

–––––––––––––––––––––––  ∙ƒ  –––––––––––––––––––––––
raw

Executing PHP scripts

If you want to execute PHP scripts, including artisan and the like, make sure to specify the PHP interpreter explicitly:

# will work
$ php artisan some:command
$ php some-script.php

# will _not_ work:
$ ./artisan some:command
$ ./some-script.php
shell

Using Composer

Using Git deployment will trigger Composer automatically. Therefore, it should not be necessary to run Composer from the environment. If you still need to run Composer manually on the app, avoid using composer update, as that will bring your local code out of sync and likely cause issues. Use composer install instead. Running Composer directly on the app is generally not necessary.

Limitations

  • This is not a root shell, so you can't install or remove software packages
  • Mind that you are using the same runtime as your web application: resource intensive operations will drain memory and CPU from the web execution
  • Worker and cron jobs are managed via the dashboard, not the shell

Written by a human. Review, grammar checks and typo fixes by AI.

AI use & editorial processEdit on GitHub ↗