> For the complete documentation index, see [llms.txt](https://docs.consuldemocracy.org/tech_docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.consuldemocracy.org/tech_docs/introduction/local_installation/vagrant.md).

# Vagrant

Install [Vagrant](https://www.vagrantup.com/) and setup a virtual machine with [Linux](/tech_docs/introduction/local_installation/prerequisites.md)

Vagrant is compatible for [Debian](/tech_docs/introduction/local_installation/debian.md) and [Ubuntu](/tech_docs/introduction/local_installation/ubuntu.md).

## Browser configuration

To access the application through the browser at `localhost:3000` we must forward a port and run the rails server with a binding option:

## Port forwarding

Open the Vagrant configuration file:

```bash
nano Vagranfile
```

Find this line:

```ruby
# config.vm.network "forwarded_port", guest: 80, host: 8080
```

And change it for this configuration:

```ruby
config.vm.network "forwarded_port", guest: 3000, host: 3000
```

Reload your virtual machine:

```bash
vagrant reload
```

## Running the rails server

In your virtual machine, run the application server, binding to your local ip address:

```bash
bin/rails s -b 0.0.0.0
```

Now you should be able to see the application running in your browser at url `localhost:3000`! :tada: