Open navClose nav
April 24, 2018 docs

GitLab SSH error

If you are getting an error when authenticating with GitLab that looks like this: Failed to authenticate SSH session: Waiting for USERAUTH response 1. Go to (where SITE-ID is the unique string in the URL when you visit your Forestry CMS). This will disconnect your account from GitLab. 2. Go to and delete the key. 3. Go to and revoke the app access. 4. Go to https://app.

February 22, 2018 docs

Could not locate Gemfile or .bundle/ directory

When I view an error log from Forestry I see: Could not locate Gemfile or .bundle/ directory What this error means Gemfiles include a list of project dependencies and where to find them. Bundler is a dependency manager for the Ruby programming language that can read Gemfiles, resolve the dependency graph and install those gems. Jekyll is a ruby application and can use Bundler to manage your project dependencies. Forestry requires that your Jekyll projects contain a Gemfile at the root of the repository.

February 1, 2018 docs

Using a Git Submodule for Your Theme

If you have a repository for your Jekyll or Hugo project and you want use a different repository for your theme, you should set up your theme repo as a Git Submodule. To add a theme as a Git Submodule, run the following command from the root of your project: git submodule add themes/hyde Be sure to add the correct URL to your theme repo and the correct path to where you want this repo to live within your project.

January 2, 2018 docs

Can't publish, preview, or save

When publishing, previewing, or saving a draft, there are a multitude of reasons why your site may fail to import. Generally, they boil down to 3 reasons: Your content files are improperly formatted. Your layout files are improperly formatted or have a build error. Our service messed up. Our bad. We output the error the caused the import to fail and allow you to view it in order to help you debug.

January 2, 2018 docs

How do I add a CNAME to my site?

For some hosting providers (such as GitHub pages) you will need to place a CNAME file in the root of your site. You’ll need to ensure that the CNAME file is treated as a static file, so that it is copied to the root of your site during the build. Make sure you place your CNAME file in your source directory, not your build directory. Otherwise it will be deleted during the next build

January 2, 2018 docs

CSS, JS, & Media not working

Sometimes you’ll find your assets aren’t loading when you preview or publish your site. This is almost always due to path issues. The best way to solve this issue is to ensure you’re always allowing your SSG (Static Site Generator) to generate URLs. For example, we have a CSS file named main.css that isn’t loading when viewing subpages. In the dev environment, we’re serving the site from localhost:4000, meaning that main.