First time setting up Trellis - docs are unclear - suggestions for the trellis docs

I would like to start with the fact that I am new to Trellis AND Vagrant. I just use the built in apache on a Mac when using wordpress. Trellis seemed so much easier so I decided to try to learn it.

I am going to go through the pages and mention what I got snagged on, as well as where I finally got stuck.

Installing Trellis ( https://roots.io/trellis/docs/installing-trellis/ )

  • Maybe mention how to install those requirements

Wordpress Sites ( https://roots.io/trellis/docs/wordpress-sites/ )

  • What would the structure look like with multiple wordpress sites?

Local Development Setup ( https://roots.io/trellis/docs/local-development-setup/ )

  • Maybe mention that running the command vagrant up should be run inside the trellis/ folder
  • How do I look at my wordpress site in the browser?

I haven’t gotten past that point, but these docs look like they’re tailored to people who know what they’re doing, not people who are new to the game.

If anything, would anyone mind telling me how to look at my site in the browser now that it is running?

1 Like

You access the site via a host that you entered such as http://example.dev. These hosts are in site_hosts.

Multiple sites:

wordpress_sites:
  site1:
    site_hosts:
      - example1.dev
    local_path: ../site # path targeting local Bedrock site directory (relative to Ansible root)
    admin_email: admin@example.dev
    multisite:
      enabled: false
    ssl:
      enabled: false
    cache:
      enabled: false
  site2:
    site_hosts:
      - example2.dev
    local_path: ../site # path targeting local Bedrock site directory (relative to Ansible root)
    admin_email: admin@example.dev
    multisite:
      enabled: false
    ssl:
      enabled: false
    cache:
      enabled: false

Thanks for the feedback.

We link to the official install/download pages for the dependencies in Trellis. It’s bad practice and redundant to replicate the official documentation for each dependency: updating the instructions would take time away from developing the features in Trellis, and the instructions will quickly become outdated when newer versions of the dependencies are released.

On the first page of the docs we link to a fully working example of a Trellis based project: https://github.com/roots/roots-example-project.com
This example project gives every command and the folder to run it from. Did you read through this?

3 Likes