Install script for the Vegvisir web framework.
Find a file
Victor Westerlund 3af40f71be feat: add RFC 2488 URL to generated .env.ini (#10)
In Vegvisir 3.4.0 ([#91](/vegvisir/vegvisir/pulls/91)) the `rfc_4288_url` will default to `null` if unset to use the system's `magic.mime` file instead. This means we need to set this variable to the "recommended" URL explicitly since it won't default to that anymore.

Reviewed-on: https://codeberg.org/vegvisir/install/pulls/10
2025-11-16 11:45:16 +01:00
install.sh feat: add RFC 2488 URL to generated .env.ini (#10) 2025-11-16 11:45:16 +01:00
README.md doc(style): use h3 heading size for argument references in README (#8) 2025-08-07 10:39:20 +02:00

Vegvisir installer

Run this script from a git repository to automatically install and configure Vegvisir as a git submodule to your project.

Important

The script will only run in environments with Bash and coreutils installed (for now).

Get started

  1. Create a git repository for your project.
  2. Run this command from the root directory of your local repository.
curl -fsSL https://codeberg.org/vegvisir/install/raw/branch/master/install.sh | bash

Arguments

You can pass optional named arguments to this script for headless installation of Vegvisir.

--install - Don't install, only configure Vegvisir

./install.sh --install=n

Pass --install=n to prevent download and installation of the Vegvisir git submodule. Use this option if you're version controlling Vegvisir from your project repository.

--dir - Installation directory

./install.sh --dir="/path/to/project"

Pass a --dir argument with a value of a directory Vegvisir should consider its root_path.

--overwrite - Overwrite configuration files

./install.sh --overwrite=y

Pass --overwrite=y to replace existing Vegvisir configuration files.

--example - Generate example website

./install.sh --example=n

Pass --overwrite=n to disable generation of an example website after installation.