Installation

Install via Docker

Vito provides a single docker image that you can install it easily!

Docker Command

docker run -v vito_storage:/var/www/html/storage \
    -v vito_plugins:/var/www/html/app/Vito/Plugins \
    -e APP_KEY=your_32_character_app_key  \
    -e NAME=admin_name \
    -e EMAIL=admin_email \
    -e PASSWORD=admin_password \
    -e APP_URL=http://your-vito-url \
    -e WS_BROADCAST_SECRET=your_websocket_secret \
    -p 80:80 vitodeploy/vito:latest

Docker Compose

version: '3'
services:
  vito:
    image: vitodeploy/vito:latest
    ports:
      - '8000:80'
    environment:
      APP_KEY: 'your-32-character-app-key'
      NAME: 'vito'
      EMAIL: 'vito@example.com'
      PASSWORD: 'password'
      APP_URL: 'http://localhost:8000' # Change this to your Vito URL
      WS_BROADCAST_SECRET: 'your-websocket-secret' # Optional, recommended for production
    volumes:
      - 'vito-storage:/var/www/html/storage'
      - 'vito-plugins:/var/www/html/app/Vito/Plugins'
volumes:
  vito-storage:
    driver: local
  vito-plugins:
    driver: local

ARM based images

For arm based architectures, you may add -arm64 to the image name. For example, vitodeploy/vito:4.x-arm64

Environment Variables

APP_KEY: A 32-character string app key used for encryption within the app.

APP_URL: The URL of your Vito instance, by default is http://localhost

NAME: Your account's name

EMAIL: Your account's email for login

PASSWORD: Your account's password for login (You can change it after login)

APP_URL: The URL of your Vito instance, It is required for some features like Vito Logs to work properly.

WS_BROADCAST_SECRET: A secret used to authenticate realtime WebSocket broadcasts. If unset, Vito falls back to APP_KEY and logs a deprecation warning. See Configuration.

Install on VPS

Vito can be installed on a fresh Ubuntu server with only one single command.

Requirements

• Ubuntu 24.04 LTS Only
• 1 GB Memory
• 1 CPU
• 80 and 443 ports should be open

Installation Process

Login to the root user of your server via SSH and run the following command:

bash <(curl -Ls https://raw.githubusercontent.com/vitodeploy/vito/4.x/scripts/install.sh)

The installation will ask you for these inputs:

Email

This is the admin email that you will use to log into VitoDeploy.

You can also pass this input as an env variable ADMIN_EMAIL

Password

This is the admin user's password.

You can also pass this input as an env variable ADMIN_PASSWORD

Ready

The installation can take several minutes, and after it is done, It will print an output like bellow:

🎉 Congratulations!
✅ SSH User: SSH-USER
✅ SSH Password: SSH-PASSWORD
✅ Admin Email: ADMIN-EMAIL
✅ Admin Password: ADMIN-PASSWORD

At this step, You can ask VitoDeploy by visiting the IP address of your server on a browser.

Now you can attach a domain and secure it.

Install Locally

To contribute to VitoDeploy and run it locally we have Laravel Sail ready!

VitoDeploy is a Laravel project which means you can follow Laravel Documentation to see how you can run it locally but here we will recommend only one way.

VitoDeploy uses OpenSSL keys to connect to your servers so you can manage them, Every Vito instance should have its own public and private key to do so. With the following command, you can generate a key pair.

If you're using Mac or Linux, You can run it on your terminal. If you're using Windows, You can run it on the app container after booting up the app via Laravel Sail.

openssl genpkey -algorithm RSA -out /PATH_TO_VITO/storage/ssh-private.pem
chmod 600 /PATH_TO_VITO/storage/ssh-private.pem
ssh-keygen -y -f /PATH_TO_VITO/storage/ssh-private.pem > /PATH_TO_VITO/storage/ssh-public.key

Laravel Sail

To run the app locally via Laravel Sail clone the repository into your local machine and then run the following commands:

Set the envs

cp .env.sail .env

Fill the .env file and then

composer install

And then boot up with Sail

./vendor/bin/sail up -d

Generate App Key

./vendor/bin/sail artisan key:generate

Create the database.sqlite in the storage folder.

Run the migrations

./vendor/bin/sail artisan migrate

Create a new user

./vendor/bin/sail artisan user:create {name} {email} {password}

Vito by default will run on localhost

Sail Documentation